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SECTION 1 
INTRODUCTION 


THE CMS CONCEPT 


CMS (Computer Management System) software is a powerful set of software items designed to operate 
on a number of different hardware products. 


To the user of an individual hardware product running CMS software, there is a well-defined operator 
interface and set of programming languages. The importance of CMS is that the same user may use 
a different hardware product running CMS software, and with the same languages. This portability 
eliminates major operator retraining between different CMS products. It also allows freedom of inter- 
change of programs between hardware products, limited only by availability of hardware features. For 
example, a program may be developed and compiled on one system, and run on another. Also, because 
the compilers are also programs, there is portability of compilers between hardware systems as well. 
Data files are similarly transferable from one system to another. This portability is achieved by building 
on the ‘“‘soft machine’? concept. Refer to figure 1-1. 
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Figure 1-1. CMS Portability 
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The programmer writes a program in a high-level language. The CMS programming languages are: 


COBOL 

RPG (including RPGII) 

MPL (CMS Message Processing Language) 
NDL (Network Definition Language) 


This program is written in ‘‘source code’’. This is then input to one of the CMS compilers which con- 
verts it to ‘‘object-code’’ or ‘‘S-code’’. This is the executable program. The ‘‘S-code’’ is similar in de- 
sign to the ‘‘machine code’’ of earlier generations of computer. 


In earlier generations of computer this ‘‘S-code’’ would be executed by hard-wired instructions. With 
the advent of fast micro-processor computers, however, it is possible to build a set of micro-instruc- 
tions which interprets each ‘‘S-code’’ and executes it. The set of micro-instructions is therefore called 
an ‘‘interpreter’’. The combination of interpreter and micro-processor hardware is sometimes termed 
a ‘‘soft machine’’. 


As the ‘‘S-code’’ is independent of any particular hardware, it is possible (and has been achieved in 
CMS) to build several soft machines which will execute an ‘‘object program’’ in a similar manner. 
Hence the CMS object programs are portable across the different CMS machines. 


These machines include: 


B 90 

B 900 
B 1800 
B 1900 


There are different CMS interpreters on each systern. For example, on the B 90 the interpreters are: 


BILINTERPX 
COBOLINTX 
NDL.INTERPX 


BILINTERPX is used to execute programs written in MPL and in BIL (an implementation language 
used for compiler-writing which is so similar to MPL that they share the same S-code format). COBO- 
LINTX is used to execute programs written in COBOL and RPG (these two languages share the same 
S-code format). NDL.INTERPX is used to interpret data communication controller programs written 
in NDL. 


Certain common features needed in all programs (such as the handling of peripheral devices) have been 
collected together into a Master Control Program (MCP). The MCP is a micro-code program and is 
therefore specifically written for each hardware product. Thus there is a B 90 MCP, B 900 MCP, 
B 1800 MCP and a B 1900 MCP. The MCP also controls the operator interface (which is standard 
across the CMS range) and maintains overall control of the system, providing complete resource man- 
agement including multi-programming, I/O device handling and memory management. 


CMS software also provides a number of utility programs. As these are written in MPL, they also 
are portable across the CMS range, limited only by hardware feature availability. 


To cover the complete features of each CMS product line, certain aspects of the software are written 
for a specific product. These additional features include important operational characteristics, and are 
described in sections 8 through 10. Sections 2 through 7 of this manual cover items which are applica- 
ble to any CMS product. 
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BASIC 
In addition to the languages mentioned above, CMS also supports BASIC. 


BASIC is a directly interpretive language, so there is no object code which has to be generated by a 
compiler. BASIC can be used from any terminal on a CMS system, including the ODT, provided that 
the system has been configured to allow this. For more information refer to the CMS BASIC Language 
Reference Manual, form number 1155819. 


SOFTWARE RELEASE LEVELS 


Each item on a CMS software release is identified by a three-part number, as follows: 
X. XX. XX 


| — patch number 
level number 


Sek READE? ~—k release number 


The mark and level numbers constitute the release number. For example, the COBOL compiler 3.05.08 
is the COBOL compiler included in the 3.05 release of system software, with patch number 08. 


Software items from different releases should not be used together. For example, an interpreter from 
release 3.05 should not be used with an MCP from release 3.04. 


This book describes system software relative to the 3.05 release. 
Software Patches 


Within a particular release, patches to individual items may be issued. For example, an MCP identified 
by 3.05.02 contains certain improvements over an MCP identified by 3.05.01. A patch always increases 
the patch number. It is always advisable to use the highest patch versions within any one release. All 
system software items within a given release (mark and level numbers) may be used together, regardless 
of the patch number, unless explicitly stated otherwise at the time of release of the item. 


Certain items may be patched by the user. The details are machine-dependent and are described in the 
relevant section (8 through 10). 


SOFTWARE SUPPORT 


Throughout this book, suggestions are made for corrective action where possible, following a particular 
output message or symptom of failure. Sometimes the phrase ‘‘request technical assistance’ has been 
used. This should be interpreted as a recommendation to contact your immediately higher support level 
if you are not sure of what to do or do not feel justified in attempting further action without com- 
petent advice. 


All problems with the system should be recorded. This is for two purposes: to report the problem; 
and to avoid similar problems in the future. The report should contain the date and time and list the 
systems. As a minimum, it is recommended that the SPO hard-copy printout or SPO log is kept for 
future reference. 
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TO THE READER 


This book is written as reference material. It is a guide to be consulted during operation of any CMS 
machine. 


This book explains how to start and stop the system software. As this is normally hardware-dependent, 
the relevant section (8 through 10) should be consulted. 


Once the system software has started (that is, the system is under MCP control), the operator may 
interface with the MCP via the SPO (Supervisory Printout) device in order to execute programs. The 
type of device may vary with the hardware product, but input and output messages are standardized. 


Section 2 of this book explains some general terms which should be understood in order to make full 
use of the CMS features. It explains how to cause programs to be executed. This section also explains 
how to read the diagrams used throughout the book to describe the format of input messages and other 
details. 


Details of input messages are given, in alphabetical order, in sections 3 and 4. The items in section 
4 are utility programs which are executed in the same manner as other programs. The items in section . 
3 are embedded features in the MCP. Refer to section 2 for a fuller explanation. 


Sections 5 and 6 describe the sort/merge feature and the compilation feature respectively, and will be 
of special interest to programmers. Section 5 includes a functional description of the sort/merge fea- 
ture. 


Section 7 lists the messages which may be output to the SPO by the system software during execution 
of the system. As each message is identified on the SPO by a number, reference to this book can be 
made by this number. 


For other items such as hardware and system software failures, refer to the particular hardware section 
section (8 through i0) for details. 
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SECTION 2 
BASIC CMS OPERATION 


INTRODUCTION 


All CMS operation has two basic principles: it is disk-based; and operator communication is with the 
MCP by a SPO device. Other peripherals may be present, depending on the configuration. This section 
introduces some basic principles which should be understood by all CMS operators. The material in 
this section is common to all CMS products. Other details that are machine-dependent are given in 


the relevant section. 


PERIPHERALS 


Each peripheral is referenced by a three-character abbreviation, where the first two characters give the 
type of peripheral and the third character refers to the particular peripheral by the letter A, B, and 
so on. For example, LP is the abbreviation for a line printer, so the first line printer is referred to 
as LPA, and the second is LPB. 


The peripheral types are listed here: 


AC — console with any output device 
AM — any multi-function card unit 

AP — any (serial or line) printer 

AR — any card reader 

AT — any magnetic tape 

CP — any card punch 

CT -—- cassette tape 

DC — data communications controller 
DF — fixed disk 

DI — industry-compatible mini-disk (ICMD) 
DK — disk cartridge 

DM — Burroughs super mini disk (BSMD and BSMDII and 5.25 inch floppy disk) 
DP — disk pack 

KB — keyboard 

LP — line printer 

MT — magnetic tape (reel) 

M8 — 80-column multi-function card unit 
M9 — 96-column multi-function card unit 
PC — console with serial printer 

P8 — 80-column card punch 

P9 — 96-column card punch 

R8& — 80-column card reader 

R9 — 96-column card reader 

RS — Reader Sorter 

RT — Real Time Clock 

SC — (console with) SELF-SCAN® device 
SD — screen display 

SP — serial printer (on console) 


If the configuration contains more than one device of the same type, the designation (A, B and so 
on) depends on the location of the peripheral controller in the hardware. 


SELF-SCAN is a registered trademark of Burroughs Corporation. 
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The three-character references are used in all operator communication with the MCP (refer to section 
3). 


SYSTEM AND USER DISKS 


The MCP resides on a disk unit. At warmstart time (when the system is started up and the MCP begins 
to function) the MCP notes the disk containing the executing MCP code. This is called the “‘system 
disk’’. 


During operation there is only one system disk. Other disks may contain a copy of the MCP code, 
but only the disk from which the MCP is running is the system disk. 


All other disks on the system during machine operation are called ‘‘user disks’’. 


There is one restriction on the portability of system disks between different CMS products. A system 
disk may not be taken to a different CMS product and used there as a system disk. It may, however, 
be used on the second system as a user disk. It may also be used on the first system as a user disk. 
User disks may always be interchanged between different systems. 


DISK FORMAT 


A disk consists of one or more platters, one or both surfaces of which may be used to record data. 
The recording area of disks is divided into the following physical items: 


Track: 


An area of one surface of a disk which is at the same distance from the center of the disk. The 
entire track can be accessed without moving the position of the read/write head. 


Sector: 


The basic unit of disk address, size 180 bytes on all Burroughs disks, and 128 bytes on ICMD. 
A physical read or write uses a complete sector. There are several additional bytes in each sector, 
used only by the hardware and not accessible to user programs. The sector is also called a ‘‘seg- 
ment’’. 


Cylinder: 


If there is more than one surface, each track at the same distance from the center makes a cylin- 
der. The entire cylinder may be accessed without altering the position of the read/write heads. 


Figure 2-1 illustrates these terms. 
Disk Initialization 


Each disk must be initialized before use on a CMS machine. Initialization creates correct sector ad- 
dresses throughout the disk recording surface, then writes certain data in the low-address part of the 
disk. The first sector is numbered sector zero, and the first track is numbered track zero. A disk with 
a bad track 0 (zero) cannot be initialized. The method of initializing the disk is machine-dependent 
(refer to the appropriate section). 


Sector zero contains the disk label. This includes the name of the disk, or ‘‘disk-id’’. Every disk has 
a disk-name. This disk-name can be from one to seven characters, using the set A to Z, 0 to 9 and 
the dot (‘‘.’’) and hyphen (‘‘—’’). 
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TOP VIEW: 
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See 4 
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na Mu 
HEADS 
S —— 
Figure 2-1. Physical Disk Structure 
Disk Files 


Information is stored on a disk in a ‘‘disk file’’. There may be many files on one disk. Each file is 
referenced by a ‘‘file name’’. A file name can be from one to twelve characters, using the set A to 
Z, 0 to 9, and the dot and hyphen. Each disk contains a directory of the files on that disk. This direc- 
tory is accessed by utilities such as KA and PD (see section 4). 


Information can be of different types: normal data, accessed by programs; special data, accessed by 
the MCP; and programs themselves. The MCP is itself a program, and so are other ‘‘system files’’ 
such as the interpreters. System files have special restrictions in that a control is placed on their re- 
moval (see RM, section 4). 


Disk File Names 


On any system, every disk file (whether data or a program) is accessed by a two part reference, as 
follows: 


disk-name/file-name 


For example, the disk file M101A/REP200 is a file with a filename REP200 to be found on the disk 
with a disk-name MI01A. 


It is not necessary to give the name of the system disk when referring to files residing on the system 
disk. Alternatively, a disk-name of 0000000 by convention refers to the system disk. For example, the 
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disk file REP200 or 0000000/REP200 is a file with a filename REP200 to be found on the system 
disk. 


It is not allowed to have two disks of the same disk-name in use at the same time. It is not allowed 
to have two files of the same file-name on the same disk. However, it is quite permissible for two 
different disks to contain a file with the same file-name. For example, the files M100A/REP200 and 
M101A/REP200 refer to two different disk files (although one may be a copy or update of the other). 


Disk File Group Names 


In many utilities (see section 4) it is convenient to refer to groups of files, depending on common start- 
ing characters of their file-names. 


All files on a disk may be referenced by the equals symbol (‘‘=’’). For example, the reference M101A/ 
= refers to all files on the disk with the disk-name MIOIA. 


All files beginning with, say, the characters REP may be referenced by REP=. For example, the refer- 
ence M101A/REP = refers to all files on disk MI01A with file-names of REP200, REPA, REP678P, 


and so on. 


In general, a group-name consists of an equals symbol (‘‘=’’) optionally preceded by up to 11 symbols 
which are the first part of the file-names of each of the files in the group. 


Example: 

Consider a disk M101A containing files with file-names: 
PR200, REP100, REP200, REP250, RQ510, CRCOPY 

Then the following group-names refer to the files indicated: 


MI01A/ = 

PR200, REP100, REP200, REP250, RQ510, CRCOPY 
M101A/REP = 

REP100, REP200, REP250 
MI101A/R= 

REP100, REP200, REP250, RQ510 


Disk Directory 


The disk directory is a table on every CMS-initialized disk which enables the MCP to locate any disk 
file by name. Full details of the directory layout are given in the CMS MCP manual. 


The directory is a fixed size determined at disk initialization time, based on the maximum number of 
files to be placed on the disk. An attempt to create more files than there are entries in the directory 
will give an appropriate MCP run-time error message. 
The directory consists of three parts: 

the name-list 

the disk file headers for each file 

the available table 
The relationship between these parts are given in figure 2-2. The name-list is a list, by file-name, of 
each file existing on that disk. A search through this name-list will reveal if a file is present or not: 
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if present, the name-list entry points to the disk file header for the file. This is a table giving the loca- 
tion of each part of actual data in the file (the file may be divided into up to sixteen separate physical 
areas on the disk). In the figure only one area is indicated. The available table is a list of the disk 
areas not in use by a file. When a new disk file is created, an available space is found from this table 
and an entry made in the name-list, then the space is used to write the file information. When a disk 
file is removed, its entry is deleted from the name-list and the areas specified in the disk file header 
are entered in the available table. 


DISK LABEL 


NAME.-LIST 


TRACK 0 


DISK FILE 
HEADERS 


DIRECTORY | AVAILABLE 


DISK SPACE 
FOR FILES 


Figure 2-2. Disk Directory Structure 


If there is insufficient space on a disk to allocate new disk file areas, COPY gets suspended by the 
MCP, waiting on available space. The operator may remove a file (see RM) to make more space avail- 
able. The KA utility (see section 4) and KX function provide information on the available space on 
a disk. The B 90 Stand-Alone utility LS will also give the available space on a disk whose files have 
been listed by an LS <disk name>/=. 


As a simplification, it may be stated that when a disk is initialized the directory is rebuilt with no 
entries, indicating that the entire disk space is available apart from the directory itself. In fact, any 
bad areas on the disk are marked in the directory so that they cannot be allocated to files (see also 
the XD utility); also, there is a special entry called ““SSYSMEM”’ which enables certain programs such 
as PD and RM (which access the directory) to operate successfully. 


Indexed Files 


Indexed files are in fact a pair of files, the ‘‘key file’? and the ‘‘data file’. They may reside on the 
same or separate disks. Each file in the pair has a separate entry in the disk directory of the disk on 
which it resides. A special table at the beginning of the key file (the ‘‘key file parameter block’’) gives, 
among other information, the disk-name and file-name of the associated data file. See figure 2-3 for 
a diagram of the relationships between the two files. 


The purpose of indexed files is to simplify access to data in the data file by using a set of keys (such 


as account number) in each record of the data file. These keys are placed in the key file. A key file 
may be created by the SORT utility and intrinsic (see section 5, where examples are given). 
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Figure 2-3. Indexed Files 


Special consideration must be given to copying indexed files, due to the link between the key file and 
data file. This is especially true when copying from one disk to another. Details are given in each rele- 
vant section (see COPY utility, section 4; also the machine-dependent copy facilities). 


Dual Pack Files 


As mentioned before, a disk file may be divided into up to sixteen separate areas. If these areas are 
located on two separate disks, the file is known as a ‘‘dual pack file’’. 


There is an entry in the directories of both disks for a dual pack file, together with the disk-name 
of the other disk. Each disk directory has a copy of the disk file header for this file, but the table 
of locations for each file area also indicates if the area is located on ‘‘this’’ disk or the ‘‘other’’ disk. 
This is shown diagrammatically for a file with four areas in figure 2-4. In most applications it is neces- 
sary for both disks of a dual-pack file to be on-line at the same time. 


NOTE 
No new dual-pack files will be created. An attempt to do so will produce an 
error message. If an old dual-pack file is accessed, a warning message will 
be issued. A future release will prevent access to old dual-pack files. 


MAGNETIC TAPE FILE NAMES 


Note: this includes tape cassette. 


A tape may be used to store data either on one file (a ‘‘single-file tape’) or as a ‘‘multifile’’ tape. 
Each file is separated by a tape mark. Additionally, each file normally has a beginning and an ending 
label. A multifile tape has also a special beginning (‘‘volume’’) label. 
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Figure 2-4. Dual Pack Files 


On loading a tape, the MCP reads the first label to determine the tape name. Tape file names are 
in two parts: 


multifile-name/file-name 


For a single-file tape, the multifile-name will be ‘‘0000000’’. The format of the multifile-name is the 
same as for the disk-name of a disk file. 


The COPY utility (section 4) produces a single-file tape when copying to tape. The backup utility and 
the LD utility (section 4) always produces multifile tapes called ‘‘library tapes’’. Library tapes are refer- 
enced by the multifile-name: there is a standard convention for labelling all the files on a library tape. 
For full details of tape formats, refer to the CMS MCP Reference manual. 


Tapes (multi-file or single-file) may be unlabelled. Such tapes must always be accessed via the AD in- 
trinsic (section 3) because there is no label that the MCP can recognize when the tape is loaded. Tapes 
containing labels that are non-standard are also treated as multifile unlabelled tapes. 


PRINTER FILES 


There are two types of printer: a wide line printer and a console printer, depending on available hard- 
ware. The console printer is also known as a ‘‘serial printer’’. These hardware devices are also referred 
to as ‘‘files’’ and are given file-names of up to seven characters. When the file is opened and closed, 
an identifying print line is given to indicate the name of the file. The identifying print line can be sup- 
pressed be setting the NO.LABEL option in the file parameter block (see MODIFY utility, section 4). 
This file-name is also used in MCP messages. Refer to the CMS MCP Reference manual for full de- 
tails. 


It is possible to designate a file type of ‘‘any printer’’. Such a file will be written to a wide line printer 
if this peripheral is available. If not available, this file will be written to the console printer if available. 
F 
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If there is no console printer either, the MCP will display a “‘NO FILE” or ‘(DEVICE REQUIRED” 
message, or if the printer backup option is on, it will direct the file to printer backup. 


OTHER PERIPHERALS 


All peripherals are treated as files for input, output or a combination of input/output, depending on 
the hardware type. The use of any peripheral device is governed by the file-name of up to seven charac- 
ters, which will appear in any related MCP messages. Refer to the OL intrinsic (section 3) for other 
details. 


PROGRAMS 


An executable program is information stored on disk as a disk file. It is referenced in the same way 
as any data file: that is, through the disk-name and file-name (or just the file-name if the program 
resides on the system disk). The rules for the program name are the same as for any disk file-name. 


A “‘utility’’ is a program provided for general use by all CMS operators, for house-keeping and other 
general purposes. For example, the LD utility enables operators to load and dump disk files from the 
disk to magnetic tape for backup purposes. 


Executing Programs 


In order to execute a program, part or all of the information in the disk file must be brought into 
memory and placed under control of the MCP. This is called ‘‘program load’’, and takes a certain 
interval of time. 


Programs may be loaded and executed by merely providing the name of program file to the MCP. 


If so desired, the keyword ‘‘EX’’ may be placed before the program name. For example, suppose one 
wishes to execute a program that resides on a disk PR200A in a file called DCS. Either the input: 


EX PR200A/DCS 
or just 

PR200A/DCS 
will cause the program to be loaded and executed. 
Depending on the system, a BOJ (beginning-of-job) message may be displayed by the MCP after the 
program has been loaded, and an EOJ (end-of-job) message may be displayed by the MCP at the end 
of the program. The display of these messages may be turned on or off for individual programs by 


the MODIFY utility (see section 4). 


Failures may occur when attempting to load a program. For example, the requested program may not 
be on disk. A list of load failure messages is given in section 7. 


Many programs enable the operator to enter further information after the program name. This is 
known as an ‘“‘initiating message’ and the contents are entirely dependent on the program. Nearly all 


the utilities in section 4 allow further information, the format of which is given in the description of 
each utility program. For example, the input: 


COPY REP202 TO RPTAPE 
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consists of the command to load and execute the program called ‘“COPY’’ (found on the system disk 
in this example), followed by the information ‘‘REP202 TO RPTAPE”’ which is passed to the pro- 
gram. There are two types of error which can be made: either there is a load failure (because, for 
example, the COPY program is not on the system disk), when the MCP would issue an appropriate 
message; or the following information is an incorrect format for the program, when the program itself 
would issue a message. In the former case, the MCP message is described in section 7. In the latter 
case, the output message is described under each utility. 


Note that if the utility resides on, say, the disk PR2, the input message would be: 


PR2/COPY REP202 TO RPTAPE 
or 
EX PR2/COPY REP202 TO RPTAPE 


In section 4 this additional information is omitted in the interest of clarity. It is, however, common 
for utilities to reside on a disk other than the system disk, in which case the disk-name must be pro- 
vided. 


It is also possible for programs to be automatically executed by another program. In this case, the 
first program is said to ‘‘zip’’ the second program. No operator input is used in this case, but the 
BOJ message may be displayed for the zipped program. 


INTRINSICS 


There is an important type of operator input that does not involve a command to execute programs 
or utilities. These messages are calls on ‘‘intrinsics’’ which are part of the MCP. Those intrinsics which 
are common to all CMS machines are described in section 3. Other intrinsics are given in the relevant 
machine-dependent section. 


Because an intrinsic is part of the MCP, there is no separate program corresponding to the name of 
the intrinsic. Therefore the keyword ‘‘EX”’ is not allowed in a call on an intrinsic, neither can a user 
disk-name be specified. There is no program load time because the MCP is already executing. For ex- 
ample, the input: 


RY DMA 


is a request to the MCP to ready (RY) the disk peripheral designated by DMA. This input message 
to the MCP must not be preceded by the keyword “‘EX”’. 


Table 2-1 is a list of intrinsics and reserved commands which cannot be used as programs or disk 
names. 


MIX NUMBERS 


As a program is loaded, the MCP assigns it a number from its table of executing tasks. This is the 
“‘mix-number’’ and is used in any messages output by MCP relating to this task. The mix-number is 
also used in all messages input by the operator for this task. Some input messages also require the 
corresponding program name as well as the mix-number. The MX intrinsic (see section 3) may be used 
to determine the current mix of tasks. 


The allocation of mix-numbers is dependent on the CMS product. Refer to the corresponding section 
for more details. 
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Table 2-1. Command Mnemonics 


Command Type of Command Function Restrictions (See Notes) | 
Mnemonic ; 


AD SCL Assign Device 3 
SCL Add Pack 
SCL Accept 
Superutility Change 
SCL Clear 
Utility Compile Utility 
Utility Compute 
SCL Gain controlling SPO 
Utility Analyse disk 
SCL Direct to Backup 4 
SCL Data Communications 
Utility Disk Dump 
SCL Dump 4 
DE | SCL Discontinue and Dump 4 
DS SCL Discontinue 4 
DT SCL Date 5 
EX SCL Execute 
FD SCL Forms Define 3 
FL Utility Display Directory 
FS Utility File Squash 
GO SCL Go 4 
GT SCL General Trace 3 
IR Superutility | Initiate Recall 
KA Utility | Disk Analyser | 
KX Superutility Interrogate filesizes | 
LB Superutility | Continue recall From earlier messages 
LF Superutility | Continue Recall | From recent messages 
LG SCL Log Go 3 
LR Utility List Regions For disk only 
LS SCL Log Stop 3 
LT SCL Load Translation table 3 
SCL Mix 
SCL New Density 3 
SCL On line 
Utility Print Backup 
Superutility Print Directory 
SCL Purge Device 3 
Utility Print Log 
SCL | Power Off 3 
Superutility Create new log files | 2 
SCL Priority 3 
SCL Reserve Device 3 
SCL Relabel Pack 3 


Superutility Remove 


Table 2-1. Command Mnemonics 


(continued) 
Command Type of Command Restrictions (See Notes) 
Mnemonic 
RY SCL Ready 3 
SF SCL Substitute file 4 — not for printer 
backup files 
SM SCL Multi-MCS data 4 
; communications | 
SN SCL Serial Number | 3 
SO CL Set PRBK Option 3 
SQ Utility Squash Disk 
ST SCL Stop 
SV SCL Save 
TL Utility Transfer Log 
TO SCL Test Options 
VF SCL Vertical Format 
WL Utility What log 
XD Utility Delete bad sectors For disk only 
ZQ Superutility Create new log files 1 
Note 1: One of the Superutility functions; zipped only by warmstart and LG. 
Note 2: Only zipped by Superutility. 
Note 3: Only valid from the system SPO. 
Note 4: Only valid from task’s originating SPO (or from system SPO). 
Note 5: Date/time may only be changed by the system operator, but can be interrogated 


by any operator. 


OUTPUT MESSAGES 


As mentioned earlier, messages may be output on the SPO either by the MCP and other system soft- 
ware or by the program. It is important to distinguish between the two types of output messages in 
order to look up the message in the appropriate place. 


Messages output by the MCP are of two kinds: short responses to intrinsics, and longer descriptions 
of any event to be brought to the attention of the operator. The short descriptions are self-explanatory. 
For example, the input message: 


OL LPA 


(an intrinsic to inquire of the status of line printer LPA) may result in the response: 
LPA READY 
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Similarly, the short message: 
LPA NOT READY 


will be displayed if LPA is stopped by the operator or through any fault. The longer descriptions are 
always referenced by an ‘‘event number’’ enclosed in brackets. The format of these messages is given 
in section 7, and operators should be generally able to recognize that such a message has been output 


by the MCP. 
For example, the message: 


10/LR PROGRAM SUSPENSION <14> 
ASSISTANCE REQUIRED FOR PRINTER FILE LRPRINT 
PRINTER NOT CURRENTLY AVAILABLE 


indicates an MCP message with event number 14. Enter HELP 10 or refer to section 7 for information 
on possible causes and suggested actions to take. 


Messages with event numbers may also be output by other parts of the system software such as inter- 
preters and the sort-intrinsic, although the overall format is similar. After recognizing the event num- 
ber, reference should be made to section 7 (or section 5 for sort-related messages). 

Messages output by all other programs are known as ‘‘displays’’? and may be preceded by the keyword 
““DISP’’. Note, however, that utility programs may display messages without this preceding keyword. 


All messages output by the utility programs described in this manual are listed under the respective 
utility. For example, messages displayed by COPY utility are listed under the COPY utility. Messages 
may additionally be displayed by the MCP for events related to the execution of the COPY, DSKUTL, 
LD and SCR utilities (for example, if the COPY utility is instructed to copy a file which does not 
exist, a “‘<file-name> NOT FOUND”’ message will be output), but these MCP messages will always 
be distinguished by the event number. 


Messages displayed by other programs are not discussed in this manual. Reference must be made to 
the appropriate manual or operating instructions for that program. 


Figure 2-5 illustrates a sample SPO list giving a mixture of messages described in this section. Note 
in this example that the utility programs LIST and LR do not give rise to BOJ and EOJ or DISP 
messages. The user program PROGA shows all three messages. These messages may be turned on for 
utilities by using the MODIFY utility (section 4). 


RAILROAD DIAGRAMS 


Most of the descriptions of input messages in this book are given as simple railroad diagrams with 
corresponding descriptive text and examples. See figure 2-6. 


To form valid input, follow the railroad ‘‘track’’ from left to right or in the direction of the arrows. 
A junction in the track indicates that alternative paths may be followed. Items enclosed in angled 
brackets (‘‘<’’ and ‘‘>’’) must be replaced with actual values, as before. Each item not enclosed in 
angled brackets is included as it is found. Spaces are added where necessary, as in format diagrams. 


There are two other features available in railroad diagrams to make possible the exact specification 
of any input message. These are illustrated in figure 2-7. 
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input command to run LIST > LIST FRED 
input command to run PROGA —> PROGA 
MCP message for PROGA BOJ = 02/PROGRA commencing 
input command to run LR > LR = 
display information of > 02/PROGA DISP: PROGRAM A 
PROGA VERSION 35 
MCP output message event 14 = 03 LR PROGRAM suspension<14> 
> Assistance required for 
printer file LRPRINT 
> Printer not currently 
available. 


input request OL jntrinsic —- OL LPA 
MCP Response to OL message > LPA LISTPRT in use by O1/lList 
input request to MX > MX 
intrinsic 
MCP response to MX message = 

> NMBR prog-name PR status 

> O01/List B executing 

— 02/PROGA A executing 

> O3/LR B suspended waiting 

on device required 
MCP message for PROGA EOJ + 02/PROGA TERMINATED 
linput request to Help —- Help 3 
intrinsic (B90 ONLY) 
MCP response to Help > Printer requested by 3/LR in 
message used by O1/LIST 
*wait until printer device 
LPA free 


«enter "DB 3' to create 
printer backup file 
End Help 
ST 1 
O1/LIST stopped. 


input request ST intrinsic 
MCP response to ST message 


+4 


Figure 2-5. Sample SPO List 


<disk-name > — / TST 200 < number > 


—— EX 


TST201 


Figure 2-6. Railroad Diagram Sample 1 


TST 200 <A> < number > 2 


<disk-name > —/ 


TST201 


Figure 2-7. Railroad Diagram Sample 
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Firstly, the maximum number of times around a loop may be controlled by including the number in 
the track of the loop. In the example, it is possible to omit the <number>, or to include either one 
or two values of <number>. Secondly, if angled brackets are to be included as part of the message, 
these must be underlined. In the example, there is an optional part of the message which consists of 
the three characters ‘‘<A>’’. The following messages would then be valid: 


EX PR2/TST200 

EX PR2/TST200 27 

EX PR2/TST201 27 56 
EX PR2/TST201 <A> 
EX PR2/TST200 <A> 56 


but the following would be invalid: 


EX PR2/TST200 27 56 243 
EX PR2/TST201 A 
EX PR2/TST201 A 73 


Note also that if a number under a loop is preceded by an asterisk (‘‘*’’), then that loop must be 
included in the syntax at least the number of times specified. For example, if the loop included the 
characters ‘‘*1’’, then the loop must be included at least once. 


SECTION 3 
CMS COMMON INTRINSICS 


INTRODUCTION 


This section describes, in alphabetical order, those input commands which are embedded in (‘‘intrinsic 
to”) the MCP and which are common to all CMS products. 


It is not valid to precede these messages with “‘EX’’, because the intrinsics are not separate programs 
to be loaded and executed. The intrinsics cannot be executed from a user disk, because they are part 
of the MCP which is on the system disk. 


The response to these intrinsics may vary slightly between CMS products, due to different hardware 
being used. Where applicable, the variations have been noted in the text. The maximum number of 
characters input to the MCP via SPO (System Command Language, SCL) is 255 (including spaces). 


SYNTAX RULES USED IN THIS SECTION 


A syntax diagram is constructed of words formed of upper— and lower-case letters, arrows, special 
characters and digits. The basic rule is that any path traced along the forward directions of the arrows 
will produce a syntactically valid statement. All words formed of upper-case letters (except ASCII) and 
all special characters (for example, commas, colons, hyphens, slashes) in the diagram must appear in 
the message as shown (acute parentheses are special characters when they are underlined). All words 


formed of lower-case letters enclosed in acute parentheses are syntactic variables representing user-sup- 
plied information. 


Any ‘‘bridge’”? over a number, such as 


3. 


may be traversed a maximum number of times specified by the digit (thirteen times in this example). 


Definition Of Syntactic Variables Used 


mix mix number. 

packid disk name or pack identifier. From 1 to 7 characters. The packid must not be 
“*0000000’’. 

mfid multiple file identification. This may be packid or the name of a tape or 
cassette. From 1 to 7 characters. 

fileid file identification. The name of the file. From 1 to 12 characters. 

progname program name. From | to 12 characters. 


Packid, mfid, fileid, progname may be constructed from the upper case alphabetic characters (A-Z), 
the numeric characters (0-9), the special characters hyphen (—) and point (.) and trailing spaces. If 
less than the maximum field size is input, the character string is padded with spaces on the right to 
complete the field size. 


peripheral a three character mnemonic. The first two characters describe the 
hardware device type and the final character describes the unit within 
that type. Units are specified by characters (A, B...) for example, 
DKC — disk cartridge, unit C. 
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device specifier 


faulty input 


device status 
serial no 


reel 
number 
priority 


either a three character mnemonic specifying a particular device type 
and unit, as for peripheral, or a two character device type specifying 
the device family. For example, DK — all disk cartridges. 


The whole of the input message up to and including the first 
element detected to be erroneous. This forms part of many output 
messages. 


The current status of the device. This wii take the form of the 
response to an OL intrinsic described mm this section. 


The six digit serial number of a disk, or the five character serial 
number of a tape. 


The tape reel number in a multi reel tape. 
An integer number. 
The priority of a program (A, B or C). 


All fields must be separated by one or more spaces. 


Output Message Rules 


All output messages are indented by three character positions to distinguish them from input messages. 
The three character positions are not available to user programs but are reserved for the system to 
provide additional information about the message. 


If the system breaks a line and inserts a CR/LF as a result of line overflow, the continuation line 
will have three dots in the first three character positions. 


Messages which have been recalled from a log file are indicated by a ‘‘/”’ in the first character position 
of each line of the message, the exception being LR when the display option is specified. 


On printer devices, each message is terminated by a carriage return to the start of a new line. 


AD (Assign Device) 


Syntax: 


sep ee eel < peripheral > | 


This intrinsic allows the operator to assign a peripheral to a program which requires a particular device. 
p prog | I 


Examples 
Example 1: 


LR utility requires a printer: 


spo input LR = 
spo output 03/LR PROGRAM SUSPENSION <14> 
spo output ASSISTANCE REQUIRED FOR PRINTER FILE LRPRINT 
spo output PRINTER NOT CURRENTLY AVAILABLE 
spo input HELP 3 
spo output PRINTER REQUESTED BY 03/LR SAVED 
spo output *ENTER “RY LPA’? TO MAKE PRINTER READY 
spo output *ENTER “AD 03 LPA’’? TO ASSIGN PRINTER 
spo output *ENTER “DB 03” TO CREATE PRINTER BACKUP FILE 
spo output END HELP 
spo input AD 3 LPA 
“spo output END LR 


The operator has assigned LPA to mix number 3. 


Example 2: 


The LIST utility requires an unlabelled tape: 


spo input LIST TAPE1 MTP NO.LABEL 

spo output 04/LIST PROGRAM SUSPENSION <28> 

spo output ASSISTANCE REQUIRED FOR TAPE FILE SPURIOUS/TAPE] 001 
spo output USE “‘AD’? TO ASSIGN DEVICE 

spo input AD 04/LIST MTA 


AD Output Messages 


Message Possible Causes Suggested Action 


AD faulty input INVALID — _ The mix number does not Use MX to find the mix number 
NO PROGRAM WITH THIS correspond to a program in of the program requiring device 


MIX NUMBER. ENTER the mix. assignment. Re-enter assignment. 
‘MX’? FOR MORE 

DETAILS. 

AD faulty input INVALID —_ The mix number and Use MX to find the mix number 
PROGRAM NAME DOES program name do not and the program name of the 
NOT MATCH MIX match. program requiring device 
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Message 


NUMBER. ENTER ‘‘MX’”’ 
FOR MORE DETAILS 


mix/progname NOT IN 
SUITABLE STATE TO 
ACCEPT ‘‘AD’”’. ENTER 
““MX’’ FOR MORE 
DETAILS. 


AD faulty input INVALID — 
DEVICE NOT ON SYSTEM. 
ENTER ‘SOL’? FOR MORE 
DETAILS. 


“AD” IGNORED — 
peripheral TEMPORARILY 
UNAVAILABLE FOR USE 
BY mix/progname. ENTER 
“OL”? AND RETRY “AD” 
WHEN DEVICE 
AVAILABLE. 


DEVICE SPECIFIED IN 
““AD’? COMMAND NOT 
SUITABLE FOR mix/ 
progname. ENTER ‘“‘MxX’’ 
FOR PROGRAM STATUS 
AND REFER TO SOG. 


“AD”? IGNORED — 
UNLABELLED DISK DRIVE 
peripheral FOR USE BY 
mix/progname MUST BE 
RESERVED FIRST. USE 
“RD”? AND TRY AGAIN. 


“AD” IGNORED — ONLY 
SYSTEM OPERATOR MAY 
ISSUE RESTRICTED 
COMMAND 


“AD mix/progname’’ 
IGNORED — DUAL PACK 
FILE CREATION IS NO 
LONGER PERMITTED 
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(continued) 
Possible Causes 


Specified program was not 
suspended waiting for a 
device assignment. 


The peripheral is not 
attached to the system. (Not 
produced on B 90). 


1. The peripheral is in use 
by another program. 

2. The peripheral is 
physically not ready. 

3. The peripheral is not 
saved. 


The device assigned does not 
meet the requirements of the 
program requiring the 
device. 


The drive was not reserved 
using the RD intrinsic. 


This intrinsic can only be 
entered from the controlling 
SPO. 


It is no longer possible to 
create a dual pack file. 


Suggested Action 
assignment. Re-enter assignment. 


Check with MX for mix number 
of suspended program and re- 
enter. 


Check with OL for required 
peripheral and re-enter. 


1. Assign another device or wait 
until the device is free. 

2. Use RY to ready the device or 
physically ready it. 

3. Use SV to save the peripheral. 


es ea 8 


Check operating instructions for 
the program. 


Use RD to reserve the required 
drive and re-enter assignment. 


Re-enter AD from the controlling 
SPO device. 


Do not use dual pack files 


AP (Add a Pack on system using Pseudo-pack, B 900 only) 


Syntax: 


=== AP <pack-id> / 
< peripheral > 


lL on — 


This intrinsic is only applicable to pseudo-packs and causes an entry for the new packid to be added 
in the pseudo-pack identifier table (PPIT). 


When a peripheral is specified, the pseudo-pack that is added is restricted to the specified device. Oth- 
erwise a non-restricted pseudo-pack will be added. This command can be used to resolve the NO-PACK 
condition. All physical units that have packids listed in the PPIT must be physically ready for the com- 
mand to be accepted. 


Example: 
The following will add a new packid to the system: 


enn input AP PACKO1/ 


OPV pepper 


spo output AP PACKO01/ ADDED TO SYSTEM 


AP Output Messages 


Message Possible Cause Suggested Action 


AP faulty input INVALID —_ The packid specified is not Check input and re-enter AP. 
DISK NAME valid. 

INCORRECTLY FORMED. 

REFER TO SOG FOR 

ALLOWABLE FORMAT 


AP faulty input IGNORED There were no fixed disk Ensure that the-fixed disk unit is 
— CANNOT CREATE units on the system when connected to the system and is 
PSEUDO-PACK ON the AP intrinsic was ready. — 

SYSTEM WITHOUT FIXED _ entered. 

DISKS 


AP faulty input IGNORED The peripheral specified is Check input and re-enter AP. 
— PSEUDO-PACKS CAN not a fixed disk. 
RESIDE ONLY ON FIXED 


DISK UNITS 
AP faulty input IGNORED A physical unit from the Ready all physical units named in 
— ALL DISKS BELONGING PPIT is not ready. the PPIT before re-entering AP. 


TO FIXED DISK 
ASSEMBLAGE MUST BE 
ON LINE BEFORE 
COMMAND ISSUED. 
ENSURE DISKS ARE 
POWERED ON 
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(continued) 
Message Possible Cause Suggested Action 
“AP”? IGNORED — The pseudo-pack identifier None. 


CANNOT ADD ANY MORE J table is full. 
PSEUDO-PACKS TO 

SYSTEM. AN EXISTING 

PSEUDO-PACK MUST BE 


USED 

“AP” IGNORED — packid/ There are two packs on the Power off one of the packs then 
IS ALREADY ONLINE system with the same name. re-enter AP. 

AP faulty input INVALID -—_ The specified peripheral is Ensure that the required 
DEVICE NOT ON SYSTEM. not on the system. peripheral is connected and ready 
ENTER ‘SOL’? FOR MORE before re-entering AP. 

DETAILS 

AP faulty input IGNORED A hardware error prevented Seek technical assistance. 

— HARDWARE ERROR the intrinsic being executed. 


ON peripheral. IF DISK, 
RUN ‘‘CHECK.DISK’’. IF 
TAPE, REPLACE MEDIA 


Lvs) 
i) 
N 


ee a 


AX (Accept a message for a program) 


Syntax: 


< text > OE 


al 


TLiin tentetnnin 
This intrinsic allows 


“AX”? command. 


the operator to communicate with a program which is suspended waiting for an 


The MCP will prompt the operator for input by printing ‘‘mix-number/program-name REQUIRES 
DATA, USE “‘AX”’ on the SPO (SCL) device. 


Any input in the text field that exceeds the size specified by the program waiting on the accept will 
be truncated. Consult the operating instructions for the program for valid ‘‘text’’ responses. 
NOTE 
“text”? begins at the first non-space character following mix-number(/pro- 
gram-name). Also a null response is a single space in the text field. A space 
is required between the mix number and (program-name). 


Example: 


The program BMO001 displays a message asking for a file name to be entered. The operator responds 


with the appropriate text, in this case ARSCIHIG, by the AX message. 


spo input BMO001 

spo output 01/BM001 COMMENCING 

spo output 01/BM001 DISP: ENTER BM202 FILE NAME 
spo output 01/BM001 REQUIRES DATA, USE “AX” 
spo input AX 1/BM001 ARSCHG 


AX Output Messages 


Message . Possible Causes Suggested Action 
mix/progname ‘“‘string”’ Program is suspended Enter accept. 
REQUIRES DATA. USE waiting for an accept. 


ss AX’? 


AX faulty input INVALID —_ The mix number does not Use MX to find the mix number 
NO PROGRAM WITH THIS _ correspond to a program in of the program requiring accept. 


MIX NUMBER. ENTER the mix. Re-enter accept. 

“MX’? FOR MORE 

DETAILS 

AX faulty input INVALID — The mix number and Use MX to find the mix number 
PROGRAM NAME DOES program name do not and the program name of the 
NOT MATCH MIX match. program requiring accept. Re- 
NUMBER. ENTER ‘‘MX’’ enter accept. 

FOR MORE DETAILS 

mix/progname NOT IN Specified program not Use MX to find mix number of 
SUITABLE STATE TO waiting for an ‘‘accept’’. program requiring accept. Re- 
ACCEPT ‘‘AX’’. ENTER enter accept. 

“MX’? FOR MORE 

DETAILS 
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Message 


**AX’”? IGNORED —- 
CANNOT USE COMMAND 
TO CONTROL PROGRAM 
INITIATED BY ANOTHER 
OPERATOR 
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(continued) 
Possible Causes 


The program was not 
executed from this SPO 
device. 


Suggested Action 


If this is the correct mix/prog- 
name then enter the accept from 
the SPO device that initiated the 
program or the controlling SPO 
device. 


CL (Clear Device) 


Syntax: 


— CL — < peripheral > “| 


This intrinsic is valid for all devices attached to m exce sed by the operator 
to clear the status of a peripheral. It can only be used when the program using the device has been 
DS’ed or DP’ed and is waiting to be cleared to allow the program to terminate. This restriction does 


not apply to B 1000. 


For example, if the line printer jams during the printing of a report and the program producing the 
report was DS’ed, the program will not terminate (go to End of Job) until the line printer is made 


ready or cleared using the CL intrinsic. 


Examples: 


spo input CL LPA 
spo input CL MTA 


CL Output Messages 


Message 


CL faulty input INVALID — 
DEVICE TYPE NOT 
ALLOWED WITH THIS 
COMMAND. REFER TO 
SOG FOR ALLOWABLE 
FORMATS . 


mix/progname NOT IN 
SUITABLE STATE TO 
ACCEPT ‘‘CL”’. ENTER 
*““MX’’ FOR MORE 
DETAILS 


CL faulty input INVALID — 
DEVICE NOT ON SYSTEM. 
ENTER ‘“‘OL’? FOR MORE 

DETAILS 


“CL” INVALID — DEVICE 
peripheral CANNOT BE 
CLEARED UNLESS IT IS 
IN USE BY A PROGRAM 
WHICH HAS BEEN 
TERMINATED BY THE 
OPERATOR. ENTER ‘“‘OL”’ 
AND ‘MX’? FOR MORE 
DETAILS 
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Possible Causes 


The specified peripheral is 
illegal. 


The program has not been 
DS’ed or DP’ed. (Not 
produced on B 90.) 


The peripheral specified is 


not attached to the system. 


The peripheral specified is 
not in use by the waiting 
program. 


Suggested Action 


Check input and clear the 
peripheral that was in use by the 
DS’ed/DP’ed program. Re-enter 
clear. 


DS or DP the program that is 
causing the trouble and clear the 
device if required. 


Use OL to find the peripheral 
that the program is attached to. 
Re-enter clear. 


Use OL to find the peripheral 
that the program is attached to. 
Re-enter clear. 


Message 


“CL” IGNORED — 
CANNOT USE COMMAND 
TO CONTROL PROGRAM 
INITIATED BY ANOTHER 
OPERATOR 


(continued) 
Possible Causes 


The program was not 
executed from this SPO 
device. 


Suggested Action 


Ensure that the SPO device used 
is the one that initiated the 
program, or use the SYSTEM 
SPO device. 


CTL (Gain/Relinquish System SPO, not implemented on 
B 1000 systems) 


Syntax: 

== or ee ON | ns 

This intrinsic allows the operator from a terminal SPO to ask for SYSTEM SPO status by issuing 
“CTL ON’’. Certain SCL commands (see table 2-1) can only be issued from the system SPO and only 
it receives certain system messages. The system SPO also has the unique ability to interact with tasks 


that have been originated from other SPOs. In response to a successful CTL ON command, the MCP 
replies with the following message: 


COMPUTER MANAGEMENT SYSTEM (CMS) 
MCP VERSION 03.05.4+ +++4++ 


“CTL”? ON COMPLETE — SYSTEM SPO STATUS ACQUIRED 
Also if the date has not been set: 


IF ACCURATE DATE/TIME IS REQUIRED, 
UPDATE USING ‘DT’ 


CTL Output Messages 


Message Possible Causes Suggested Action 
CTL faulty input IGNORED 1. The station or line is not 1. Ready station or line then re- 
— TERMINAL NOT IN ready. enter CTL. 


SUITABLE STATE TO 
BECOME SYSTEM SPO. 
REFER TO SOG FOR 
MORE DETAILS 


2. The station is disabled 2. None. 
input or output. 
3. The MCS owning the 3. None. 
station is not running. 
‘CTL ON’ IGNORED — This terminal is already the None. 
THIS ALREADY IS THE SYSTEM SPO. 
SYSTEM SPO 
‘CTL ON’ IGNORED — A SYSTEM SPO already None. 
ANOTHER SPO exists. 
CURRENTLY HAS SYSTEM 
SPO STATUS 
SYSTEM SPO STATUS 1. A successful CTL OFF 
REMOVED has been performed. 


2. The local SPO has taken 
SYSTEM SPO status. 

3. The line or station has 
gone not ready. 
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(continued) 
Message Possible Causes 


‘CTL OFF’ IGNORED — This terminal did not have 
THIS IS NOT THE SYSTEM SYSTEM SPO status. 
SPO 


None. 


Suggested Action 


DB (Direct To Backup) 


Syntax: 
—— DB — <mix> 
/ <progname > 
—TOo— <packid > / < fileid > 
where 
packid This is the name of the disk or pack on which the printer backup file will be 
placed. If no disk name is specified, the printer backup designate disk will be 
used. 
fileid This is the file name which will be given to the printer backup file. If no file 


name is given, a file name of the form PBnnnnn (where nnnnn is a five digit 
progression number in the range 00001 to 65535) will be used. 


This intrinsic allows the operator to direct the printer output of a program, which is waiting for a 
physical printer, to a printer backup file if there is a printer availability problem. DB overrides both 


the option selected by the program, via its File Parameter Block, and the system options in force, due 
either to the intrinsic SO or the default contained in SYSCONFIG file (see CONFIGURER utility.) 


Examples: 

Example 1. 

The program WRITER is waiting on a printer: 

spo output 22/WRITER <28> PROGRAM SUSPENSION <14> 


ASSISTANCE REQUIRED FOR PRINTER FILE WRITER 
PRINTER NOT CURRENTLY AVAILABLE 


spo input DB 22 

spo output 22/WRITER PRINTER BACKUP FILE printer-backup-designate-disk-name/ 
PBnnnnn OPENED 

spo output 22/WRITER PRINTER BACKUP FILE printer-backup-designate-disk-name/ 


PBnnonnn CLOSED 


A printer backup file calied PBnnnnn has been written to the system printer backup designate disk 
(if available, otherwise the system disk will be used). Note that nnnnn is a five digit progression number 
generated by the system. 


Example 2. 


To direct the output of the program BM902 to printer backup on disk named PRINTO2 with the file 
name BMPRINT the following occurs: 


spo output 01/PRINTER PROGRAM SUSPENSION <14> 
ASSISTANCE REQUIRED FOR PRINTER FILE BM302 
PRINTER NOT CURRENTLY AVAILABLE 


spo input DB 01/PRINTER TO PRINT02/BMPRINT 
spo output 01/PRINTER WRITER BACKUP FILE PRINT02/BMPRINT OPENED 
spo output 01/PRINTER WRITER BACKUP FILE PRINT02/BMPRINT CLOSED 
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DB Output Messages 


Message 


DB faulty input INVALID — 
NO PROGRAM WITH THIS 
MIX NUMBER. ENTER 
‘MX’? FOR MORE 
DETAILS 


DB faulty input INVALID — 
PROGRAM NAME DOES 
NOT MATCH MIX 
NUMBER. ENTER ‘‘MX”’ 
FOR MORE DETAILS 


mix/progname NOT IN 
SUITABLE STATE TO 
ACCEPT ‘‘DB’’. ENTER 
“MX”? FOR MORE 
DETAILS 


DB faulty input IGNORED 
~ SPECIFIED PRINTER 
BACKUP DISK NOT 
ONLINE. RETRY 
COMMAND WITH DISK 
ONLINE 


DB faulty input IGNORED 
— DUPLICATE PRINTER 
BACKUP DISKS ONLINE. 
POWER OFF ONE AND 
RETRY COMMAND 


DB IGNORED — CANNOT 
USE COMMAND TO 
CONTROL PROGRAM 
INITIATED BY ANOTHER 
OPERATOR 


Possible Causes 


The mix number does not 
correspond to a program in 
the mix. 


The mix number and 
program name do not 
match, 


1. The mix number specified 
did not require a printer. 


2. The initiating message 
was incomplete. 


The disk specified is not 
present. 


Two disks with the specified 
name exist on the system. 
This will only occur on 
systems which run with 
Pseudo packs. 


The program was not 
executed from this SPO 
device. 


Suggested Action 


Use MX to find the mix number 
of the program requiring printer 
device. Re-enter direction to 
backup. 


Use MX to find the mix number 
and the program name of the 
program requiring printer device. 
Re-enter direction to backup. 


1. Use MX to find the mix 
number of the program requiring 
printer device. 


2. Check input. Re-enter direction 
to backup. 


Load and ready required disk and 
re-enter direction to backup. 


Remove one of the disks and re- 
enter direction to backup. 


Ensure that the SPO device used 
is the one that initiated the 
program or use the SYSTEM 
SPO device. 


DC (Data Communications operator input) 


Syntax: 


— Dc — <text> ee 


This intrinsic allows the operator to enter messages from the SPO (SCL) device to the Message Control 

System (M CS), if the data communications lay is in process. The message text, after being stripped 

of the ‘“‘DC”’ characters and leading spaces, is transferred to the MCS input message queue and marked 
s ‘“‘operator input’’. 


The interpretation of the message text is defined by the particular MCS. 


Example: 


To enter the text ‘“‘RY S 0”’ the following would be input: 


spo input DC RY S 0 
spo output FROM MCS: RY OK (126) 
spo output FROM MCS: STATION 0/AP300XA31 READY (212) 


DC Output Messages 


Message Possible Causes Suggested Action 
“DC” INVALID — NO There is no MCS in the Check input. Execute the MCS if 
MCS PROGRAM RUNNING _ mix. required. Re-enter DC command. 
“DC”? IGNORED — NO There is no DC message Wait a short time, then re-enter 
DATACOMM BUFFER space, in which to transfer message. If unsuccessful several 
SPACE AVAILABLE FOR the message text. times, request technical assistance. 


MCS MESSAGE. TRY 
AGAIN LATER 


“DC”? IGNORED — FIRST The MCS is not running. Check input. Execute the MCS if 
DEFINED MCS NOT required. Re-enter DC command. 
RUNNING. USE ‘‘SM’’ TO 
SPECIFY MCS REQUIRED 
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DM (Dump program, only implemented on B 1000) 


Syntax: 


— DM — <mix> / <progname > 


AT i ae < line number > 
< psn > — <spn > —< pca> 


This intrinsic allows the operator to create a dumpfile at any point of program execution, without dis- 
continuing the program. When the dump is finished, the program can be restarted with the GO com- 
mand. 


If the mix/progname only is specified, the dumpfile will be created immediately. For COBOL pro- 
grams, a line number can be specified (in the range 1 to 65535) and the dumpfile will be created when 
the program reaches that line number. Note that the COBOL program must be compiled with a $LINE- 
COUNT card. 


= code segment number 
spn = procedure number 
= procedure offset 


where psn and spn are in the range 0 to 255, and pca is in the range 0 to 65535. The correspondence 
between a particular program statement and the above parameters can be found by using the $KXMAP 
control card at compile time or MPL.LISTS. 


Example: 


The COBOL user program called TESTER is to be dumped at line number 25000. (The mix number 
of TESTER is 20, this may be found using the MX command). 


spo input DM 20/TESTER AT 25000 
spo output DUMPFILE SYSTEM/DMFIL20 CREATED 
RUN DUMP ANALYSIS UTILITY TO DETERMINE PROGRAM FAULT 


DM Output Messages 


Message Possible Causes Suggested Action 


DM faulty input INVALID The mix number does not Use MX to find the mix number 
— NO PROGRAM WITH correspond to a program in of the program to be 


THIS MIX NUMBER. the mix discontinued. Re-enter DM input. 
ENTER ‘‘MX’’? FOR MORE 

DETAILS 

DM faulty input INVALID The mix number and Use MX to find the mix number 
— PROGRAM NAME DOES program name do not and the program name of the 
NOT MATCH MIX match. program to be discontinued. Re- 
NUMBER. ENTER ‘MX’? enter DM input. 


FOR MORE DETAILS 
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a sss. _ ) 00: 


Message 


DM faulty input 
INCOMPLETE -— BOTH 
MIX NUMBER AND 
PROGRAM NAME MUST 
BE SPECIFIED. ENTER 
“MX’? FOR MORE 
DETAILS 

DUMPFILE NOT CREATED 
FOR mix/progname 
“STRING”? DUE TO DISK 
HARDWARE ERROR 


DUMPFILE packid/ 
DMFILmix CREATED. RUN 
DUMP ANALYSIS UTILITY 
TO DETERMINE 
PROGRAM FAULT 
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(continued) 
Possible Causes 


The program name is also 
required. 


An error has occurred while 
opening, writing to or 
closing the dumpfile. The 
program, however, can stili 
be restarted if desired. 

The dump file is created. 


with the name disk-name/ 
DMFILmix-number. 


Suggested Action 


Re-enter DP input with program 
name. 


Call for technical assistance. 


Now DUMP ANALYZE utility 
can be run to determine program 
fault. 


DP (Discontinue and Dump) 


Syntax: 


— DP—<mix> / < progname > ——————_| 


This intrinsic is similar to the ‘‘DS’’ intrinsic. The difference is that the disk work space (Virtual Mem- 
ory on Disk) is not cleared and returned to an available status. 


Instead, the disk work space is updated from memory with all the most current information about the 
program. The disk work space is then made into a file and given a name, ‘‘DMFILnn’’ where ‘nn’ 
is the mix number of the program that was DP’ed. 


The peripherals and memory in use by the specified program are made available to other programs. 


DP is used when a technical analysis of a particular program is required following a failure during 
its operation. The DMFILE produced using the DP intrinsic can then be analyzed using the system’s 
DUMP/ANALYZER utility. See section in this manual relating to system being used for description 
of the DUMP/ANALYZER utility. 


Example: 


The user program called GLO60 must be terminated. The following would be input on the SPO device 
to dump the program. 


spo output 20/GL060 MUST BE TERMINATED 
spo output ENTER: 
“DS 20/GL060’? — TO TERMINATE OR 
“DP 20/GL060’> — TO TERMINATE WITH DUMP 


spo input DP 20/GL060 

spo output DUMPFILE DMFIL20 CREATED 

spo output RUN DUMP ANALYSIS UTILITY TO DETERMINE PROGRAM FAULT 
spo output 20/GL060 TERMINATED (DP’ED) 


DP Output Messages 


Message Possible Causes Suggested Action 
DP faulty input INVALID — The mix number does not Use MX to find the mix number 
NO PROGRAM WITH THIS correspond to a program in of the program to be 
MIX NUMBER. ENTER the mix. discontinued. Re-enter DP input. 
“MX’? FOR MORE 
DETAILS 
DP faulty input INVALID -— The mix number and Use MX to find the mix number 
PROGRAM NAME DOES program name do not and the program name of the 
NOT MATCH MIX match. program to be discontinued. Re- 
NUMBER. ENTER ‘‘MX’’ enter DP input. 
FOR MORE DETAILS. 
DP faulty input The program name is also Re-enter DP input with program 
INCOMPLETE — BOTH required. name. 


MIX NUMBER AND 
PROGRAM NAME MUST 
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Message 
BE SPECIFIED. ENTER 
“MX”? FOR MORE 
DETAILS 


DUMPFILE NOT CREATED 
FOR mix/progname 
“STRING” DUE TO DISK 
HARDWARE ERROR 
DUMPFILE packid/ 
DMFILmix CREATED. RUN 
DUMP ANALYSIS UTILITY 
TO DETERMINE 
PROGRAM FAULT 


“DP”? IGNORED — 
CANNOT USE COMMAND 
TO CONTROL PROGRAM 
INITIATED BY ANOTHER 
OPERATOR 
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(continued) 
Possible Causes 


For some hardware reason 
the DMFILE cannot be 
created. 


The dump file is created 
with the name disk-name/ 
DMFILmix-number. 


The program was not 
executed from this SPO 
device. 


Suggested Action 


Call for technical assistance. 


Now dump analysis utility can be 
run to determine the program 
fault. 


Ensure that the SPO device used 
is the one that initiated the 
program, or use the SYSTEM 
SPO device. 
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DS (Discontinue Program) 


Syntax: 


— DS— <mix>/ < progname > —_——_——_ 


This intrinsic causes the orderly termination of the specified program. All peripherals in use by the 
program are made available to other programs. 


NOTE 
The CL intrinsic may have to be used to allow the program to terminate if 
it is waiting for a NOT READY device. See CL intrinsic. 


Example: 


The user program called GLO60 must be terminated. The following would be input on the SPO device 
to discontinue the program. 


spo output 20/GL060 MUST BE TERMINATED 
spo output ENTER: 
“DS 20/GLO060”" — TO TERMINATE OR 
“DP 20/GLO60 TO TERMINATE WITH DUMP 
spo input DS 20/GL060 
spo output 20/GL060 TERMINATED (DS’ED) 


DS Output Messages 


Message Possible Causes Suggested Action 
DS faulty input INVALID -— The mix number does not Use MX to find the mix number 
NO PROGRAM WITH THIS correspond to a program in of the program to be 
MIX NUMBER. ENTER the mix. discontinued. Re-enter DS input. 
“MX’’? FOR MORE 
DETAILS 
DS faulty input INVALID -— The mix number and Use MX to find the mix number 
PROGRAM NAME DOES program name do not and the program name of the 
NOT MATCH MIX match. program to be discontinued. Re- 
NUMBER. ENTER ‘‘MX’”’ enter DS input. 
FOR MORE DETAILS 
“DS”? IGNORED — The program was not Ensure that the SPO device used 
CANNOT USE COMMAND executed from this SPO is the one that initiated the 
TO CONTROL PROGRAM device. program or, use the SYSTEM 
INITIATED BY ANOTHER SPO device. 
OPERATOR 
DS faulty input The program name is also Re-enter DS input with program 
INCOMPLETE — BOTH required. name. 


MIX NUMBER AND 
PROGRAM NAME MUST 
BE SPECIFIED. ENTER 
““MX’” FOR MORE 
DETAILS 
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DT (Set System Date and Time) 


Syntax: 


to “interrogate “the system date and time (if there is a real time clock « on the system). 


The response to a valid DT command is of the format: 


—— dd mon yy yyddd 
dow aa hhmm al 
where: 
dd = The day of the month. 
mon = A three character abbreviation for the month (for example, JAN, FEB) 
= The last two digits of the year (for example, 82, 83) 
yyddd = The julian date. 
dow = A three character abbreviation for the day of the week (for example, SUN, 
MON) 
hhmm = hh is the hour Q4 hour clock} and mm is the minutes. 
Examples 
Example 1. 


To inquire about the system date (and time if the system contains a real time clock): 


spo input DT 
spo output 12 OCT 82 82285 TUE 1132 
Example 2. 


To set the system date and time to July 9th 1975 and 2:35 p.m. 


spo input DT 7/9/75 1435 
spo output 09 JUL 75 75190 WED 1435 
Example 3. 


To just change the time to 11:45 a.m. 


spo input DT 1145 
spo output 09 JUL 75 75190 WED 1145 
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DT Output Messages 


Message 


DATE INCORRECT. USE 
FORMAT ‘‘MM/DD/YY’’ 
WITH VALID NUMBERS. 


TIME INCORRECT. USE 
FORMAT ‘‘HHMM”’ WITH 
VALID NUMBERS 


NO CLOCK ON SYSTEM. 
TIME PARAMETER 
IGNORED 


“DT” IGNORED — DATE 
OR TIME MAY ONLY BE 
CHANGED BY SYSTEM 
OPERATOR. OTHER 
OPERATORS MAY ONLY 
INTERROGATE DATE OR 


TIME. 


Possible Causes 
The date is incorrect. 


The time is incorrect. 


The time has been input to 
a system without a real time 
clock. 


The time and date can only 
be changed from the system 
SPO. 


Suggested Action 


Check input and re-enter DT 
command. 


Check input and re-enter DT 
command. 


None. 


Re-enter DT from the controlling 
SPO device. 


EX (Execute a program) 


Syntax: 


< progname > ————_> 
ee 5 Re eee: 


7 a rn aa ar <1 


ye MEM ———— <real store > 


FILE i < internal filename > — = <packid > / < fileid > 


i <mfid > / <fileid > 


fe < text > z) 


cH 
lA 
IV 

eee re 


< reel no> 


This intrinsic allows the operator to initiate the loading and subsequent execution of the specified pro- 
gram. 


The optional fields contained within acute parentheses, ‘‘<’’ and ‘‘>’’, are special instructions to the 
loader. The special instructions may be in any order. They are identified by their keyword (MEM and 
FILE) and terminated by another keyword or the closing acute parenthesis. 


The use of the real store special instruction MEM is machine dependent; the value specified is a number 
of bytes. See relevant MCP reference manual. 


The FILE special instruction specifies a comma list of file name equations. The equation is in terms 
of the internal file name as recorded in the internal file name block of the program file. The equation 
is therefore invariant under File Parameter Block (FPB) modification. A FILE special instruction 
causes the specified internal filename to be substituted for the filename in the FPB which corresponds 
to it. It should be noted that filename equation will be ineffective for programs which dynamically 
edit their FPB. (All utility programs dynamically edit their FPB.) 


The text field is dependent on the program. See operating instructions for the particular program. 


Examples: 
Example 1. 
spo input EX LIST FRED A 
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This executes the LIST utility and passes the text ‘‘FRED A”’ to the LIST utility. 
Example 2. 
spo input LR = 
This executes the LR utility and passes the text ‘‘=’’ to the LR utility. 
EX Output Messages 


For error messages see section 7, Loader Detected Failures. 


FD (Form Define not implemented on B 1000) 


Syntax: 


For serial printer: 


— FD —— SPA 


< offset > 


< width > 


For terminal SPOs running Multiple Terminal SPO (MTS), B 90/B 900 systems only: 


< height > iMen ciles < width > — + 


———- FD STATION 


This intrinsic allows the operator to define a logical page for a serial printer (SPA) or set top of page 
for SPA. When used with STATION, the command can only be issued from a terminal SPO on a 
system running MTS. 


The three parameters are as follows: 


height This is the page height which defines the number of lines forming a page. 
When page height has not been defined or has been defined as zero (0), skip 
to top of form will execute four line advances, giving three blank lines (serial 
printer only). 
If specified for a terminal SPO this value must be in the range 1 to 255 and 
be suitable for the terminal configuration used. 


width This is the page width (maximum record size), which specifies the number of 
characters in a line. 
If specified for a terminal SPO this value must be in the range 20 to 255 and 
be suitable for the terminal configuration used. 


offset This is the physical column number, on the printer, corresponding to column 
zero (0) of the logical page. 


NOTE 
The WIDTH and OFFSET added together must not be greater than the num- 
ber of physical print positions on the serial printer. For example, if the 
physical printer had 255 columns, the maximum printing area is given by a 
WIDTH of 255 and OFFSET of zero. 


The FD command may also be applied without any parameters to a serial printer. This declares the 
current position of the loaded form to be at top of page. 
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When any of height, width, or offset are changed the new values are recorded, and remain in effect 
after system shutdown and warmstart. 
Examples: 
Example 1. 
spo input FD SPA 63,120,105 


This sets 63 lines as the page height, 120 characters as the page width and first character on the line 
will be at 105th print position of the physical printer. 


Example 2. 
spo input FD SPA , ,95 


This changes the start position of the first character print on a line to the 95th print position of the 
physical printer. The HEIGHT and WIDTH settings will remain as they were. 


Example 3. 

In order to change the top of page position, move the paper to the desired position then input: 
spo input FD SPA <empty> 

Example 4. 


To set a SPO capable terminal to have page size of 24 and width of 80 (providing the terminal has 
been successfully configured with these values) input from the terminal: 


spo input FD STATION 24,80 
FD Output Messages 


Message Possible Causes Suggested Action 
FD faulty input INVALID -—_ There is no serial printer on Check with OL to find mnemonic 
DEVICE NOT ON SYSTEM. | the system. for the serial printer on the 
ENTER ‘‘OL’”? FOR MORE system. Re-enter FD command. 
DETAILS. 
FD faulty input IGNORED The serial printer is in use. Wait until the printing has ended 
— DEVICE MUST NOT BE then re-enter FD command. 


IN USE WHEN COMMAND 
ISSUED. ENTER ‘‘OL”’ 
AND RETRY WHEN 
DEVICE FREE. 


FD faulty input INVALID — _ The FD specifications are Check input and re-enter FD 
PARAMETERS ILLEGAL not acceptable. command. 

OR OUT OF RANGE. 

REFER TO SOG FOR 

ALLOWABLE FORMAT. 
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Message 


FD faulty input INVALID — 
HEIGHT MUST BE IN 
RANGE 1-255 AND WIDTH 
IN RANGE 20-255. RETRY 
“FD STATION” WITH 
CORRECT PARAMETERS. 


FD faulty input INVALID — 
DEVICE TYPE NOT 
ALLOWED WITH THIS 
COMMAND. REFER TO 
SOG FOR ALLOWABLE 
FORMATS. 


FD faulty input INVALID — 
“FD STATION’ MAY 
ONLY BE USED TO 
ALTER SCL TERMINAL 
SCREEN SIZE. REFER TO 
SOG FOR MORE DETAILS. 


2032801 


(continued) 
Possibie Causes 


The parameters specified in 
an FD command are found 
to be out of range. 


An illegal peripheral was 
specified in an FD 
command. 


An FD station command 
was entered from SPO 
which is not a terminal 
SPO. 


Suggested Action 


Check input and re-enter FD 
STATION command with valid 
parameters. 


Check input and re-enter FD 


command. 


None. 
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GO (Restart a Stopped Program) 


Syntax: 


/ <progname > 


This intrinsic allows the operator to restart a program which has been stopped with the ST or DM 
(B 1000 only) command or a PAUSE communicate. 


Examples: 


Example 1. 


To restart the program whose mix number is 3: 


spo input GO 3 


Example 2. 


To restart the program PRO20 whose mix number is 20: 


spo input GO 20/PRO20 


GO Output Messages 


Message 


GO faulty input INVALID — 
NO PROGRAM WITH THIS 


MIX NUMBER. ENTER 
““MX’’ FOR MORE 
DETAILS 


GO faulty input INVALID — 


PROGRAM NAME DOES 
NOT MATCH MIX 
NUMBER. ENTER ‘“‘MX”’ 
FOR MORE DETAILS 


“GO”? IGNORED — mix/ 
progname NOT STOPPED. 


ENTER ‘‘MX’’ FOR MORE 


DETAILS STOPPED 


GO IGNORED — CANNOT 


USE COMMAND TO 
CONTROL PROGRAM 
INITIATED BY ANOTHER 
OPERATOR. 


Possible Causes 


The mix number does not 
correspond to a program in 
the mix. 


The mix number and 
program name do not 
match. 


Specified program was not 
suspended as a result of an 
ST command. (Not 
produced on a B 90 when 
the program is executing.) 


The program was not 
executed from this SPO 
device. 


Suggested Action 


Use MX to find the mix number 
of the program to be restarted. 
Re-enter GO command. 


Use MX to find the mix number 
and the program name of the 
program suspended waiting for 
“GO’’. Re-enter GO command. 


Check with MX for suspended 
program waiting on ‘‘GO”’’. Re- 
enter GO command. 


Ensure that the SPO device used 
is the one that initiated the 
program or use the SYSTEM 
SPO device. 


A 


HELP (Detailed Task Information on B90 Only) 


a = ia 
/ < progname > 


This intrinsic allows the operator to inquire about the state of any program currently processing. If 
the specified program is not suspended when the HELP intrinsic is issued, then a status message similar 
to the MX intrinsic response is produced: 


Syntax: 


—— HELP 


message 2 —— 


—— mix/progname message 1 


For messagel and message2 refer to the MX intrinsic. 


If the program is suspended, the output of the HELP intrinsic is: 


—— _inf.msg ee eee ee END HELP 


66RD? 


‘+#? ig used to indicate alternative procedures to resolve the suspension. Only one should be chosen 
by the operator from each list of action messages. 


Examples: 

Example 1: 

spo input LR = 

spo output 04/LR PROGRAM SUSPENSION <14> 

spo output ASSISTANCE REQUIRED FOR PRINTER FILE LPRINT 

spo output PRINTER NOT CURRENTLY AVAILABLE 

spo input HELP 4 

spo output *ENTER “RY LPA’? TO MAKE PRINTER READY 

spo output *ENTER ‘“‘AD 04 LPA’’ TO ASSIGN PRINTER 

spo output *ENTER “DB 04’? TO CREATE PRINTER BACKUP FILE 

spo output END HELP 

Example 2: 

spo input MX 

spo output NMBR PROG-NAME PR STATUS 

spo output 12/FATALPROG B SUSPENDED WAITING ON OPERATOR INPUT 

spo output END MX 

spo input HELP 12 

spo output 12/FATALPROG ENCOUNTERED FATAL ERROR AND MUST BE 
TERMINATED 

spo output *ENTER “DS 12/FATALPROG”’ TO TERMINATE 

spo output *ENTER “DP 12/FATALPROG”’ TO TERMINATE WITH DUMP 

spo output END HELP 
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HELP Output Messages 


Message Possible Cause Suggested Action 


HELP faulty input INVALID The mix number does not Use MX without mix number. 
— NO PROGRAM WITH correspond to a program in 


THIS MIX NUMBER. the mix. 

ENTER ‘‘MX’’ FOR MORE 

DETAILS 

HELP faulty input INVALID The mix number and Use MX without the mix number 
- PROGRAM NAME DOES program name do not and the program name. 

NOT MATCH MIX match. 


NUMBER. ENTER ‘‘MX’’ 
FOR MORE DETAILS 
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LG (Start system message logging) 


Syntax: 


aig ie Se 


patente cen gto 


TLi. ¢ ete oxy 
LILES PILETISIV SLALLS 5 


ys ok g 
(at the next warmstart the default option set via CONFIGURE 


the LS command. 


LG Output Messages 


Message 
‘LG’? IGNORED — ONLY 
SYSTEM OPERATOR MAY 
ISSUE RESTRICTED 
COMMAND 


SYSTEM LOGGING 
COMMENCED 


SYSTEM LOGGING 
ALREADY IN OPERATION 
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continues 


Possible Cause 


This intrinsic can only be 
entered from the controlling 
SPO. 


Logging was successfully 
started. 


LG was issued while logging 
was already on. 


ntil either the system is powered off 


R is acted on), or countermanded by 


Suggested Action 


Re-enter LG from a controlling 
SPO device. 


None. 


None. 


a a i ee 


LS (Stop system message logging) 


Syntax: 
— ts — 


This intrinsic stops the logging of system messages. If logging was initiated by the LG command, error 
message logging is also stopped. Logging remains stopped until either the system is powered off (at 
the next warmstart the default option set using CONFIGURER will be acted on), or LS is counter- 
manded by the LG command. 


LS Output Messages 


Message Possible Cause Suggested Action 


“LS”? IGNORED — ONLY This intrinsic can only be Re-enter LS from a controlling 
SYSTEM OPERATOR MAY _ entered from the controlling SPO device. 
ISSUE RESTRICTED SPO. 


COMMAND. 

SYSTEM LOGGING Logging was successfully None. 
STOPPED stopped. 

SYSTEM LOGGING LS was issued while logging None. 
ALREADY STOPPED was already OFF 


LT {Load Translation table, only implemented on B 90) 
B 1000 users see section 10 of this manual for LT utility. 


Syntax: 


— LT — < peripheral > 


< translator > ————~} 


This intrinsic builds a logical connection between the specified device and the translation table, such 
that data passing to/from the device is subject to translation as defined by the translation table. 


Only local keyboard, printers that are not connected via datacomm, CRT and SELF SCAN can have 
translation specified. 


This intrinsic causes the translation table, specified in the file SYSTRANS, to be used and stores appro- 
priate information in the file SYSCONFIG so that it is remembered through system power off and 
warmstart. This only occurs if the device has already had a translation table assigned, when CONFI- 
GURER was executed. 


The translator name is a character string of up to 20 characters which must have the following format: 
device.style.language.version 
for example: SP.B932.UK.V2 
For details, refer to SYSTRANS format in section 8. 7 
Example: 
To load and assign the German version of the translator to the line printer B 9249-30, the fol- 


lowing syntax is used: 


spo input LT LPA LP.B924930.GRMNY.V5 
spo output TRANSLATION TABLE LOADED FOR DEVICE LPA 


LT Output Messages 


Message Possible Cause Suggested Action 
LT faulty input IGNORED The device is in use, or is Check input and that the device 
— DEVICE MUST NCT BE invalid. Also the input to is online and ready, before re- 
IN USE WHEN COMMAND — LT may be incorrect. entering LT. 


ISSUED. ENTER ‘‘OL”’ 
AND RETRY WHEN 
DEVICE FREE 


LT faulty input INVALID — The specified device is not Check input and ensure the 
DEVICE NOT ON SYSTEM. present. device required is connected to 
ENTER ‘OL’? FOR MORE the system and is ready. 
DETAILS 

“LT? IGNORED — The system file SYSTRANS, Copy the file SYSTRANS to the 
TRANSLATION FILE NOT which contains the system disk and re-enter LT. 
AVAILABLE. COPY translation tables is not 

SYSTRANS FILE TO present on the system disk. 
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ee 


Message 


SYSTEM DISK AND RETRY 


COMMAND 


“LT”? IGNORED — 
SPECIFIED TRANSLATION 
TABLE NOT FOUND IN 
TRANSLATION FILE. 
SPECIFY ANOTHER 
TABLE OR ADD NEW 
TABLE TO SYSTRANS 
FILE 


“LT” INVALID — 
SPECIFIED TRANSLATION 
TABLE NOT APPLICABLE 
TO DEVICE peripheral. 
RETRY COMMAND USING 
DIFFERENT TABLE 


SPECIFIED TRANSLATION 
TABLE WILL NOT BE RE- 
LOADED AT NEXT 
SYSTEM POWER UP 
SINCE NO SYSCONFIG 
TABLE ENTRY EXISTS. 
RUN ‘‘CONFIGURER”’ TO 
CREATE TRANSLATION 


ENTRY FOR. peripheral AND 


RETRY COMMAND 


“LT” IGNORED — 
HARDWARE ERROR ON 
SYSTEM DISK WHILST 
ACCESSING SYSTRANS 
FILE. RUN ‘‘CHECK.DISK”’ 
TO LOCATE ERROR 


“LT”? IGNORED — ONLY 
SYSTEM OPERATOR MAY 
ISSUE RESTRICTED 
COMMAND 


(continued) 
Possible Cause 


The required translation 
table is not present in 
SYSTRANS. 


The file SYSTRANS on the 
system disk is incompatible 
with this system. 


This device did not have a 
translation table assigned to 
it in the system file 
SYSCOMFIG. 


A hardware error has 
occurred while accessing thE 
system disk. 


This intrinsic can only be 
used from the system SPO. 


Suggested Action 


Check input to ensure that the 
correct translation table was 
requested. 


Copy the correct version of 
SYSTRANS onto the system disk 
and then re-enter LT. 


Execute CONFIGURER utility 
and assign the table to the 
device. 


Run CHECK.DISK to locate 
error. 


Re-enter LT command from 
system SPO device. 


I 


MX (Display Current Mix) 


Syntax: 


—- MX 


This intrinsic allows the operator to inquire about the state of any program(s) currently processing. 
The general format of the output produced by the MX intrinsic is: 
—— NMBR PROG-NAME PR STATUS 


mix/progname —————_ priority message 1 message 2 


NO PROGRAMS RUNNING 
>—_—_—— eno ax —— 


Where priority: 

aes = 
I B 1 
ene 


Where : 
A — lowest priority (application programs) 
B — medium priority (system programs, for example, utilities) 
C — highest priority (programs using data communications) 


Message! : 
EXECUTING 
SWAPPED OUT 
TERMINATING 
SHORT WAITED ON 
SUSPENDED WAITING ON 
SWAPPED OUT, WAITING ON 
TERMINATING, SUSPENDED WAITING ON 

Where: 

EXECUTING — the program is processing normally. 

SWAPPED OUT — the program’s work area has been transferred to disk. 

TERMINATING — the program is going to end the job. 

SHORT WAITED ON — the program is waiting on the reason stated in message2. 

SUSPENDED WAITING ON — the program has been temporarily halted, waiting on the reason 
stated in message2. 

SWAPPED OUT, WAITING ON — the program’s work area has been transferred to disk to allow 
other programs to use the work area while the program waits for 
the reason stated in message?2. 

TERMINATING, SUSPENDED —the program will finish once the resource stated in message2 

WAITING ON becomes available. 
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eee 


message2: 


RESTORE 
VM 
SCL TASK 
o/c 
SPO OUTPUT 
EOJ 
0 
NO FILE 
DUP FILE 
DISK SPACE 
DIRECTORY SPACE 
DEVICE REQUIRED 
FORMS REQUIRED ac | 
FILE USE 
BAD FILENAME 
WAITING MCS ATTACHMENT 
DC OM BUFFER SPACE 
MCS QUEUE 
STATION QUEUE LIMIT —————________ 


ACCEPT 
ZIP Sn 
EVENT TIMER 

DS OR DP 

GENERATION NUMBER MISMATCH 

BUSY SUPERUTILITY 

SUBNET QUEUE 

MCS QUEUE LIMIT 

COMPLETE EVENT 

JOB START 

BUFFER SPACE 

SHARED BUFFER 

LOCKED DISK 


INCOMPLETE FILE ———————________________ 
ieee ae 
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Where: 
Message 


RESTORE 
VM 
SCL TASK 


O/C 


SPO OUTPUT 
EOJ 


1/O 


NO FILE 


DUP FILE 


DISK SPACE 


DIRECTORY SPACE 


DEVICE REQUIRED 


2032801 


Meaning 


The program is waiting for 
Virtual Memory. 

The program is waiting for an 
MCP intrinsic to be completed 


(such as the response to an OL). 


The program is waiting for 
a file to be opened or 
closed. 


The program has gone to 
end of job. 


Usually indicative of normal 
processing, involving input/ 
output activity to a 
peripheral. 


The program requires a 
particular file, which has not 
been found, to continue 
processing. 


The program is attempting 
to place a file of a certain 
name on the disk. However, 
another file by the same 
name currently resides on 
the disk. A disk may not 
contain two files with the 
same name. 


The available space on the 
disk is insufficient to hold 
the file the program is 

attempting to write; or the 
disk is ‘‘checkerboarded’’. 


When the disk was 
initialized, the directory was 
constructed to contain a 
fixed number of file names. 
The directory has now 
reached its capacity. 


The program requires a 
particular device to continue. 


Suggested Action 


None: Do not try to execute too 
many programs at this time. 


None: The program will resume 
execution when the SCL task has 
finished. 


None. The program will resume 
execution when the required file 
has opened or closed. 


None. 


None. 


Check SPO for message 
indicating name of the file 
required and make the file 
available. If in doubt refer to 
operating instructions for the 
program. 


Either remove the existing file 
with RM or change its name with 
CH. If in doubt refer to the 
program instructions. 


With the KA utility analyse the 
amount of space remaining. If 
the disk is full, remove any 
unnecessary files with RM. If the 
disk is checkerboarded, DS the 
program then use the SQ utility 
to consolidate disk space. Re- 
execute the suspended program. 


Remove with RM any unnecessary 
files and the program will 
continue; or DS the suspended 
program and replace the disk 
with another having sufficient 
directory space, and re-execute 
the program. 


Make the device physically and 
logically ready by using the RY 
intrinsic. Or assign an alternative 
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Message 


FORMS REQUIRED 


FILE USE 


BAD FILENAME 


WAITING MCS 
ATTACHMENT 


DCOM BUFFER SPACE 
JEUE 


STATION QUEUE LIMIT 
ACCEPT 


OPERATOR INPUT 


ZIP 


EVENT TIMER 


DS OR DP 


Meaning 


The program requires a 
printer with special 
stationery. 


The program requires access 
to a disk file which is 
already being used by the 
maximum number of co- 
existent users. 


The program has displayed 
an “‘ACPT”’ message on the 
SPO device and is waiting 
for an appropriate response. 


The program is waiting for 
some input from the 
operator. For example a 
program previously 
suspended by the ST 
intrinsic. 

The program has initiated 
the execution of another 
program by means of a ZIP 
communicate and is now 
waiting for that program to 
finish. 

The program has issued a 
wait for a finite number of 
seconds. 


The program has performed 
an illegal act. 


A 


Suggested Action 


device to the program using the 
AD intrinsic. 


Ensure that a printer containing 
the required stationery is ready, 
then assign the program to that 
printer using the AD intrinsic. 


None. The program will resume 
execution when one of the other 
users closes the file, allowing this 
user (program) to open the file. 


Refer to the program’s operating 
instructions for the required 
response. Then respond using the 
AX intrinsic. 


Provide the program with the 
appropriate input. The program 
will continue executing. For the 
example given, the GO intrinsic 
would be used. 


None. 


None. The program will resume 
when the time interval has 
expired. 


Use the DP command to stop 
program and dump its workspace. 
Copy the dump file, program and 
the current SYS-LOG-file to 
removable media. Send these files 
along with an explanation to the 
person responsible for the 
program. Or if this is a known 
problem then use the DS intrinsic 
to terminate the program. 


Message 


GENERATION NUMBER 
MISMATCH 


BUSY SUPERUTILITY 


SUBNET QUEUE 
MCS QUEUE LIMIT 
COMPLEX EVENT 


JOB START 
BUFFER SPACE 


SHARED BUFFER 
LOCKED DISK 


INCOMPLETE FILE 
BLOCK LOCK 


MX Output Messages 


Message 


MX faulty input INVALID 
— NO PROGRAM WITH 
THIS MIX NUMBER. 
ENTER ‘“‘MX’’? FOR MORE 
DETAILS 


MX faulty input INVALID 

— PROGRAM NAME DOES 
NOT MATCH MIX 
NUMBER. ENTER ‘‘MX’”’ 
FOR MORE DETAILS 
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(continued) 
Meaning 


The program requires to use 
a function which is part of 

the SYS-SUPERUTL utility. 
SYS-SUPERUTL is already 

performing a function. 


The program has issued a 
complex wait communicate 
and is waiting for one cr 
more of the events specified 
by the communicate to 
finish. 


Another program has opened 
the SYSMEM file on a disk 
to which the suspended 
program requires access. 


When using shared files, the 
program has output 
capability on a shared file 
and is trying to access a 
record in a block of that 
file that has been read by 
another output capable 
program. 


Possible Causes 


The mix number does not 
correspond to a program in 
the mix. 


The mix number and 
program name do not 
match. 


Suggested Action 


None. 


None. 


None. The program will resume 
once the the SYSMEM file has 
been closed. 


None. The program will resume 
once the other program has 
updated the record or accesses a 
record outwith that block. 


Suggested Action 
Use MX without mix number. 


Use MX without the mix number 
and the program name. 


ND (New Density, only implemented on B 90) 


Syntax: 


< density > —— 


This intrinsic allows the operator to define the print density on suitable console printers and soft swit- 


chable CRTs. For printer devices, the density field is a single character which specifies the density as 
follows: 


—— ND —— < peripheral > 


A. the greatest number of characters per inch available on the printer 
B. the second highest number of characters per inch and so on. 


1. the greatest number of lines per inch available on the printer. 
2. the second highest number of lines per inch, and so on. 


For printer devices, when the number of characters per inch changes, the operating system will adjust 
the values of page width and offset (previously set by a FD command or by default), so that any subse- 
quent output is restricted to the part of the platen available with the previous density. Similarly, page 
height will be adjusted when the number of lines per inch changes. The new density together with the 
adjusted values of page height or page width and offset are recorded in a systern configuration file 
and are remembered through system shutdown and warmstart. 


For screen devices, the density field is a single character which specifies the density as follows : 


A. the greatest number of characters available on the screen. 
B. the second greatest number of characters available and so on. 


On screen devices, the ND command applies only to the character size used for console file use. If 
the screen is being used in SPO/Console mode, the SPO mode will have the greatest number of charac- 
ters available. At warmstart, if any inconsistency is found between the system configuration file infor- 
mation (ND and FD values for printers) and the capability of the current device, then the system con- 


figuration file information is ignored and default values used. The system configuration file is unal- 
tered. 


The densities available on different printers are as follows: 


Peripheral Density Value 
120 cps console printer 15 characters per inch A 
10 characters per inch B 
90 cps console printer 16 2/3 characters per inch A 
12 1/2 characters per inch B 
10 characters per inch C 
8 lines per inch | 
6 lines per inch 2 


ND Output Messages 


Message 


ND faulty input IGNORED 
~ DEVICE MUST NOT BE 
IN USE WHEN COMMAND 
ISSUED. ENTER ‘‘OL”’ 
AND RETRY WHEN 
DEVICE FREE. 


ND faulty input INVALID — 
DEVICE NOT ON SYSTEM. 
ENTER ‘‘OL’”?’ FOR MORE 
DETAILS 


‘ND’? IGNORED — ONLY 
SYSTEM OPERATOR MAY 
ISSUE RESTRICTED 
COMMAND 


ND faulty input INVALID — 
PARAMETERS ILLEGAL 
OR OUT OF RANGE. 
REFER TO SOG FOR 
ALLOWABLE FORMAT 
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Possible Causes 


1. The specified value of 
density exceeds the number 
of options available on the 
device. 


2. The device is in use. 


3. The peripheral specified is 
unsuitable. 


The specified peripheral is 
not connected to the system. 


This intrinsic can only be 
entered frorn the controlling 
SPO. 


The ND specifications are 
not acceptable. 


Suggested Action 
1. Correct and re-enter ND. 


2. Wait until the program using 
the device has finished with it 
and then re-enter ND. 

3. Check input. 


Check input and ensure the 
required peripheral is connected 
to the system before re-entering 
ND. 


Re-enter ND from the controlling 
SPO device. 


Check input and re-enter ND 
command. 
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OL (Request Status Information of Peripherals 


Syntax: 


ee eee 
< device specifier > 


This intrinsic allows the operator to request the status of peripherals on the system. If a specific device 
is named (for example CTA) in the command, only the status for that peripheral, if any, is given. 
If the device specifier names a device family, then the status for all devices in that family is produced. 
If the device specifier is omitted, the status of all devices on the system is given. 


The system responses vary depending on whether the device in question is a disk, magnetic tape, data 
communications, clock, or other device. 


Response for a disk device: 


—— device spec packid / number FILES OPEN 
1 x SYS DISK ie | | T 
F NOT READY 1 a | 
POWERED OFF RESERVED 


NOT READY 


RESERVED 
In addition, if a fixed disk assemblage is the system disk, the status of “‘system disk’’ applies to all 
the fixed disk units. The system response for each fixed disk unit will not contain the phrase ‘‘SYS 
DISK’’, but the last line of the response will be 

“device type mnemonic = SYS DISK” 
indicating that the fixed disk assemblage is the system disk. 


response for magnetic tape: 


—— device spec NOT READY 
PURGED —— < serial no > 


UNLABELLED NO WRITE PERMIT 


mfid/ i 5 cee a < serial no > (enor a eee eel A 
fileid reel EXPIRY DATA EXCEEDED 


UNLABELLED ———H— AA t= 


‘NO WRITE PERMIT SAVED 


IN USE BY mix/progname 


NOT READY 


NO WRITE PERMIT NOT READY 


response for data communication and clock devices: 


== device specifier —————___—_—_—_—— 


response for other devices: 


— dev spec ——— NOT READY $$ 


READY = SAVED —_l 
fileid 
mfid/ ew ee ea IN USE BY — mix/progname 
fileid J L_. NOT READY SAVED 
UNLABELLED 
Examples: 
Example 1. 


To find the status of all Burroughs Mini disks (DM) on the system : 


spo input OL DM 

spo output DMA C34B90B/ NOT READY 0 FILES OPEN 
spo output DMB NOT READY 

spo output DMC RESERVED 0 FILES OPEN 

spo output DMD NOT READY RESERVED 0 FILES OPEN 
spo output END OL 

Example 2. 


To find the status of line printer LPA : 


spo input OL LPA 


spo output LPA PRINTOOT IN USE BY 10/LIST 
spo output END OL 


OL Output Messages 


Message Possible Causes Suggested Action 
OL faulty input INVALID -— A non-existent device has Check input and re-input if 
DEVICE TYPE NOT been specified. necessary. 


ALLOWED WITH THIS 
COMMAND. REFER TO 
SOG FOR ALLOWABLE 
FORMATS 


OL faulty input INVALID — _ The device or family None. 
DEVICE NOT ON SYSTEM. | specified is not connected to 

ENTER ‘‘OL’? FOR MORE the system. 

DETAILS 
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PG (Purge Tape) 
Syntax: 


— PG 


< peripheral > + 


This intrinsic allows the operator to purge (erase) magnetic and cassette tapes, providing the tape is 
write enabled. This labels the tape as available for output use. 

Examples: 

Example 1. 


To purge a cassette on drive CTA: 


spo input PG CTA 
spo output CTA PURGED 12345 
Example 2. 


To purge a magnetic tape on drive MTA: 


spo input PG MTA 
spo output MTA PURGED ????? 


NOTE 
In example | the numbers 12345 were produced, this is the original serial 
number of the tape. In example 2 the question marks are output as this is 
a new tape with no serial number on it. 


PG Output Messages 


Message Possible Causes Suggested Action 
PG faulty input IGNORED The tape is not write Write enable the tape and re- 
— UNABLE TO PURGE enabled. enter PG command. 
WRITE-PROTECTED TAPE 
PG faulty input IGNORED The device is in use. Wait until the device is free or 
— DEVICE MUST NOT BE use another tape device. Re-enter 
IN USE WHEN COMMAND PG command. 


ISSUED. ENTER ‘‘OL”’ 
AND RETRY WHEN 
DEVICE FREE. 


PG faulty input INVALID —_ The device specified is Check and correct input and re- 
DEVICE TYPE NOT illegal. enter PG command. 
ALLOWED WITH THIS 

COMMAND. REFER TO 

SOG FOR ALLOWABLE 

FORMATS. 


PG faulty input INVALID —_ The tape device specified is Use OL to find tape device 
DEVICE NOT ON SYSTEM. not connected to the system. connected to the system. If a 
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Message 
ENTER ‘‘OL’”? FOR MORE 
DETAILS 


PG faulty input IGNORED 
—- HARDWARE ERROR 
ON peripheral. IF DISK, 
RUN ‘‘CHECK.DISK’’. IF 
TAPE, REPLACE MEDIA 


‘PG’? IGNORED — ONLY 
SYSTEM OPERATOR MAY 
ISSUE RESTRICTED 
COMMAND 
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(continued) 
Possibie Causes 


An Input/Output error has 
been detected on the tape 
device. For example, a 
parity error. 


This intrinsic can only be 
entered from the controlling 
SPO. 


Suggested Action 
suitable device is present, use it. 
Re-enter PG command. 


Use another tape and re-enter PG 
command. If this message is 
repeated with the same drive, 
seek technical assistance. 


Re-enter PG from the controlling 
SPO device. 
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PO (Power Off a disk) 


Syntax: 


— PO 


< peripheral > ———_—_——_—_—+ 


This intrinsic is applicable to disk devices only. It allows the operator to “‘logically’’ power off a disk 
(instruct the MCP that the disk is no longer required), before it is physically powered off. The system 
may be powered off when there are no programs in the mix. For a system running with a data comm 
SPO (SCL) device then NDL, MCS and SPIM can be present in the mix. This causes the MCP to 
terminate. All system disk files will be closed and SYS-SUPERUTL will go to End of Job (EOJ). 


Do not remove a disk from the disk drive, power down the disk unit, or switch off the main cabinet 
until disks have been logically powered off with PO and the number of files open on the disk is zere 
(0). Failure to observe this practice might cause disk problems at a later date. 

Examples: 


Example 1. 


To power off the disk named DOCFO1 in drive DMB 


spo input PO DMB 

spo output DISK DOCF01/ IN DRIVE DMB NOT IN USE 
spo output DISK (IF NOT FIXED) MAY NOW BE REMOVED 
Example 2. 


To power off the disk in drive DKB 


spo input PO DKB 
spo output DKB D34B8/ POWERED OFF 2 FILES OPEN 


At this point the cartridge cannot be removed as there are still files open. The operator must wait for 
a message indicating that there are no files open (that is zero files open): 


spo output DKA D34B8/NOT READY 0 FILES OPEN 
PO Output Messages 


Message Possible Causes Suggested Action 
DISK packid/ IN DRIVE The disk has been logically None. 
peripheral NOT IN USE. powered off and can be 
DISK (IF NOT FIXED) removed or physically 
MAY NOW BE REMOVED powered off. 
DISK packid/ IN DRIVE The disk has been marked The operator must wait until the 
peripheral HAS number as logically powered off. number of files open on the disk 
FILES OPEN AND IS is zero (0) before the disk is 
STILL IN USE. A removec or physically nowered 
FURTHER MESSAGE WILL off, 
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Message 
INDICATE WHEN DISK 
NO LONGER IN USE 


PO faulty input IGNORED 
— DRIVE NOT READY 


PO faulty input INVALID — 
DEVICE TYPE NOT 
ALLOWED WITH THIS 
COMMAND. REFER TO 
SOG FOR ALLOWABLE 
FORMATS 


PO faulty input INVALID — 


DEVICE NOT ON SYSTEM. 
ENTER ‘“‘OL’? FOR MORE 
DETAILS 


CLOSEDOWN MIX (SEE 
SOG FOR DEFINITION) 
MUST EXIST BEFORE 
SHUTTING DOWN 
SYSTEM. ENTER ‘‘MX”’ 


FOR DETAILS. 


WEN arava casas 


TERMINATE NON- 
CLOSEDOWN PROGRAMS 
AND TRY ‘‘PO’”’? AGAIN 


CLOSEDOWN MIX (SEE 
SOG FOR DEFINITION) 
MUST EXIST BEFORE 
SHUTTING DOWN 
SYSTEM. ENTER ‘‘MX”’ 
FOR DETAILS. 
TERMINATE NON- 
CLOSEDOWN DATA 
COMM PROGRAMS AND 
TRY “PO”? AGAIN 


HARDWARE ERROR ON 
DISK peripheral DURING 
“PO”. DISK NOT 
POWERED OFF. RUN 
“CHECK.DISK’’ TO 
DETERMINE FAULT 


“PO”? IGNORED — ONLY 
SYSTEM OPERATOR MAY 
ISSUE RESTRICTED 
COMMAND 


DISK packid/ IN DRIVE 
peripheral GONE NOT 
READY WHILST NOT IN 
USE WITHOUT ‘“‘PO” 
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(continued) 
Possible Causes 


The device is not ready. 


The device specified is 
illegal. 


The device is not connected 
to the system 


The system disk is powered 
off until the mix is empty. 
That is, no programs 
running. 


The system is running data 
comm and the SPO (SCL) 
is not being run from the 

data comm. 


An Input/Output error has 
occurred on the drive. 


This intrinsic can only be 
entered from the controlling 
SPO. 


The user disk has been 
removed without using the 
PO intrinsic. 


Suggested Action 


None. 


Use OL to find the correct device 
and re-enter PO command. 


Use OL to find the correct device 
and re-enter PO command. 


Ensure that all programs have 
gone to End of Job (note: SPIM, 
NDL, and MCS can remain in 
the mix of a datacomm SPO 
system), then re-enter PO 


command 


Halt the data comm and then re- 
enter PO command. 


Re-enter PO command. If the 
error continues, seek technical 
assistance. 


Re-enter PO from the controlling 
SPO device. 


Re-load the disk into the same 
drive and use the PO intrinsic to 
logically power off the drive and 
wait for the system to respond 
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Message 
BEING ISSUED. RELOAD 
DISK 


If there are any files left 
open on the disk then this 
message appears: 

DISK packid/ IN DRIVE 
peripheral GONE NOT 
READY WHILST IN USE. 
RELOAD DISK 


(continued) 
Possible Causes 


Suggested Action 
that the disk may be removed. 


PR (Assign Program Pricrity, not implemented on B 90 
systems) 


Syntax: 


—— PR <mix > / < progname > A 
| B 
Lé¢ 


This intrinsic allows the operator to alter the priority of a program by moving it to the highest priority 
position in the class specified. 


A This is low or normal priority, used for regular work. Within this class, programs which 
perform more physical Input/Output operations are given precedence. 
B This is medium priority, used for utilities or programs which may be expected to do 


emergency work. The priority within this class is reverse historical; that is a program of 
this priority placed in the mix will take precedence over previous programs of the same 
priority. 


C This is high priority, used for data communications programs that are transaction-driven. 
These are normally dormant, awaiting a transaction, but when required to process a 
transaction they take high priority to minimize response times. Within this class programs 
which do more physical Input/Output are given precedence. 


Example: 
To change the priority of mix number 3 (program REPS506) to B: 


spo input PR 3/REP506 B 
spo output PRIORITY OF 03/REP506 PR CHANGED TO B 


PR Output Messages 


Message Possible Causes Suggested Action 
PR faulty input Mix number and program Check with MX for proper input 
INCOMPLETE — BOTH name do not match or do and re-enter PR command. 
MIX NUMBER AND not exist. Or the priority 


PROGRAM NAME MUST value is incorrect. 
BE SPECIFIED. ENTER 
“MX’’ FOR MORE 


DETAILS 
PR faulty input INVALID — The PR specifications are Check input and re-enter PR 
PARAMETERS ILLEGAL not acceptable. command. 


OR OUT OF RANGE. 
REFER TO SOG FOR 
ALLOWABLE FORMAT 
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RD (Reserve Disk Drive) 


Syntax: 


— RD 


< peripheral > _—_——_ 


This intrinsic applies only to disks and may not be applied to the system disk. 

This intrinsic allows the operator to reserve a peripheral. If the peripheral is not physically ready when 
the RD is performed, it is marked. When it is subsequently made ready, physically powered on, no 
AVR will be performed but the device will be marked physically ready and reserved. 


If the peripheral is physically ready when RD is issued, the device is marked reserved and no further 
labelled opens are allowed. Any jobs using the device are allowed to terminate normally. 


A reserved device may be ‘“‘unreserved’’ by use of the RY intrinsic. 


Examples 
Example 1. 
If the disk in drive DMA is to be reserved, the following should be entered: 


spo input RD DMA 
spo output DMA RESERVED 0 FILES OPEN 


If there was no disk in the drive then the following would happen: 


spo input RD DMA 
spo output DMA NOT READY RESERVED 


RD Output Messages 


Message Possible Causes Suggested Action 
RD faulty input INVALID — _ The specified peripheral is Check input and re-enter reserve 
DEVICE TYPE NOT either not a disk, is the command. 
ALLOWED WITH THIS system disk, or is illegal. 


COMMAND. REFER TO 
SOG FOR ALLOWABLE 


FORMATS 

RD faulty input INVALID —_ The specified disk is not Check input and ensure required 
DEVICE NOT ON SYSTEM. connected to the system. drive is connected to the system 
ENTER ‘SOL’? FOR MORE then re-enter reserve command. 
DETAILS 


“RD” IGNORED — ONLY This intrinsic can only be Re-enter RD from the controlling 
SYSTEM OPERATOR MAY _ entered from the controlling SPO device. 

ISSUE RESTRICTED SPO. 

COMMAND 
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RL (Relabel Disk/Pack) 


Syntax: 

— RL < old packid > / ir (era ha < new packid > ——————__ 
Lt 

The RL intrinsic allows the operator to change the disk name, packid and pseudo-packids that are pres- 


Three conditions are required for this command to be accepted: 


1. If a pseudo-packid is being relabelled, all physical units that have packids listed in the PPIT 
must be physically ready. 


2. If the disk to be relabelled is not a system disk, there must be no files open on the disk. 


3. If the disk to be relabelled is a system disk, a null mix must exist (no programs running). On 
a remote SPO (SCL) system the only programs running should be SPIM, the MCS that is man- 
aging the remote system (usually MCSOBJ) and NDLSYS. 


When the disk requested to be changed is a pseudo-pack, this command causes the entry for the packid 
in the pseudo-pack identifier table to be changed to the new packid. When the packid requested to 
be changed identifies a physical disk, this command also causes the packid in the disk label field of 
the designated physical unit to be updated with the new disk name and assigns the unit to the system 
with this new disk name. 


WARNING 
RL will not correct disk file headers of dual pack file components or Key 
File Parameter Blocks (KFPB). That is, a key file on the disk that is linked 
to a data file on the same disk will not have its KFPB corrected to point 
to the new name of the disk. 


Example: 
To change the diskname DCO286 to DOCOLD: 


spo input RL DOC286/ TO DOCOLD/ 
spo output DOC286/  RELABELLED AS DOCOLD/ 


RL Output Messages 


Message Possible Causes Suggested Action 
“RL”? IGNORED — DISK The specified disk is not Use OL to find if the disk 
packid/NOT PRESENT. present on the system, or is required is present and the name 
POWER ON DISK AND associated with a reserved of the disk. Re-enter RL 
RETRY COMMAND disk. command. 
“RL” IGNORED — DISK A duplicate pack condition Remove the duplicate pack and 
packid/ ALREADY ON has been detected. re-enter RL command. 


SYSTEM. REMOVE/ 
RELABEL DUPLICATE 
DISK OR CHOOSE 
DIFFERENT DISK NAME 
AND RETRY COMMAND 
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_—_—Os ne 


Message 


RL faulty input IGNORED 

— ALL DISKS BELONGING 
TO FIXED DISK 
ASSEMBLAGE MUST BE 
ONLINE BEFORE 
COMMAND ISSUED. 
ENSURE DISKS ARE 
POWERED ON 


RL faulty input INVALID — 
DISK NAME 
INCORRECTLY FORMED. 
REFER TO SOG FOR 
ALLOWABLE FORMAT 


“RL” IGNORED -— 
CANNOT RELABEL DISK 
AT THIS TIME. TRY 
AGAIN LATER 


RL faulty input IGNORED 
~ DEVICE MUST NOT BE 
IN USE WHEN COMMAND 
ISSUED. ENTER ‘“‘OL”’ 
AND RETRY WHEN 
DEVICE FREE. 


RL faulty input IGNORED 
— HARDWARE ERROR 
ON peripheral. IF DISK, 
RUN ‘“‘CHECK.DISK’’. IF 
TAPE, REPLACE MEDIA 


“RL” IGNORED — ONLY 
SYSTEM OPERATOR MAY 
ISSUE RESTRICTED 
COMMAND 


(continued) 
Possible Causes 


At least one physical unit 
from the PPIT (pseudo-pack 
only is not ready. 


The disk name specified is 
not in CMS standard 
format. 


There are programs running 
on the system disk, other 
than those required for 
remote SPO (SCL) 
operation. 


There are files open on the 
disk to be relabelled. 


A hardware error prevented 
the command being 
executed. 


This intrinsic can only be 
entered from the controlling 
SPO. 


Suggested Action 


Ready the units and re-enter RL 
command. 


Check input and re-enter RL 
command. 


Wait until a null mix occurs, 
then re-enter RL command. 


Wait until there are no files open 
on the disk before re-entering RL 
command. 


Re-enter RL command. If this 
condition continues to occur, seek 
technical assistance. 


Re-enter RL from the controlling 
SPO device. 


RY (Ready Device) 


Syntax: 


< peripheral > ———_—_——_————_ 


This intrinsic is used to ‘“READY”’ a peripheral so the MCP can use it as a resource. When warm- 
starting, the system will automatically ready all peripherals on the system that are powered on. RY 
may also be used to ready a previously powered off (PO) user disk, a peripheral that is saved (SV) 


and disk that has been reserved (RD). 


— RY 


When this intrinsic is applied to a fixed disk assemblage, it applies to all the fixed disk units. The 
peripheral field must be specified as ‘device type mnemonic=”’ (for example DF=) and a request to 
ready a single fixed unit will be rejected. When the intrinsic is accepted, all fixed disk units, except 
those which are physically powered off, will be readied. 


NOTE 
For B 9252 line printers on B90 systems, the printer normally remains 
logically ready at all times. If the printer does go logically not ready, the job 
using the printer is suspended. If a VF command is sent to the printer from 
the SPO and the printer is logically not ready, the SPO hangs. Recovery is 
possible in both these cases by powering the printer off and then on. 


Examples: 
Example 1. 


Ta ready the line printer LPB, enter the following: 


spo input RY LPB 
spo output LPB READY 
Example 2. 


To ready the magnetic tape on drive MTB, enter the following: 


spo input RY MTB 
spo output MTB NOT READY 


In this case the drive is not physically ready. This could be because there is no tape in the drive, the 
drive is not powered on, or the drive failed to recognize the tape for some reason. 


Example 3. 
To ready the disk drive DMA, enter the following: 


spo input RY DMA 
spo output DMA DOC286/ 0 FILES OPEN 
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RY Output Messages 


Message 


RY faulty input INVALID — 
DEVICE NOT ON SYSTEM. 
ENTER ‘OL’? FOR MORE 
DETAILS 


RY faulty input INVALID — 
DEVICE TYPE NOT 
ALLOWED WITH THIS 
COMMAND. REFER TO 
SOG FOR ALLOWABLE 
FORMATS 


“RY”? IGNORED — ONLY 
SYSTEM OPERATOR MAY 
ISSUE RESTRICTED 
COMMAND 
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Possible Causes 


The peripheral specified is 
not connected to the system. 


The peripheral specified is 


invalid. 


This intrinsic can only be 
entered from the SPO. 


Suggested Action 


Check input and ensure the 
required device is connected to 
the system. Re-enter RY. 


Check input then re-enter correct 
peripheral mnemonic in RY. 


Re-enter RY command from the 
system SPO device. 


SF Substitute File (Not implemented on B 90) 


Syntax: 
— SF < mix > <mfid > / ———j—_—_ 
fe: / < progname > a }-- <mfid> / < fileid> ~ 
L—_—— < fileid > ———— 


This intrinsic is valid only for disks. 


The substitute file intrinsic allows the operator to direct a program to a particular disk file if it is wait- 
ing on a ‘‘NO FILE’’, ‘‘NO PACK’’, ‘‘DUPLICATE FILE” or ‘‘SBAD FILE NAME”’ condition. 


This command causes temporary modification to the program’s file parameter block (FPB). The 
modification remains in effect for the current execution only, or until it is remodified by the program 
during execution. 

This intrinsic must not be applied to printer backup files. AD should always be used. 

The operator may not anticipate a program’s needs and pre-modify an FPB that might cause a suspen- 
sion in the future. 

Examples: 


Example 1. 


Program AP10 (mix number 01) requests a disk file called APD2T on disk APD. To direct the program 
to use the file APD2A on the same disk: 


spo output 01/AP10 <10> WAITING APD/APD2T DK ON FILE 
spo input SF 01/AP10 APD2A 
Example 2. 


To direct the same program in example 1 to use file APD2T on the disk called APD1, input one of 
the following: 


spo input SF 01/APD10 APD1/ 
or 

spo input SF 01 APD1/ 

Example 3. 


To direct the same program in example 1 to use file ATEMP on the disk called ARTD, input the fol- 
lowing: ; 


spo input SF 01 ARTD/ATEMP 
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SF Output Messages 


Message 


SF faulty input INVALID — 
NO PROGRAM WITH THIS 
MIX NUMBER. ENTER 
“MX”? FOR MORE 
DETAILS 


SF faulty input INVALID — 
PROGRAM NAME DOES 
NOT MATCH MIX 
NUMBER. ENTER ‘‘MX’”’ 
FOR MORE DETAILS 


mix/progname NOT IN 
SUITABLE STATE TO 
ACCEPT ‘‘SF’’. ENTER 
“MX”? FOR MORE 
DETAILS 
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Possible Causes 


The mix number does not 
correspond to a program in 
the mix. 


The mix number and 
program name do not 
match. 


Specified program was not 
suspended waiting. 


Suggested Action 


Use MX to find the mix number 
of the program requiring device 
assignment. Re-enter SF. 


Use MX to find the mix number 
and the program name of the 
program requiring device 
assignment. Re-enter SF. 


Check with MX for mix number 


SM (Multi-MCS data communications Send Message) 
Syntax: 


—— SM ———— < mix > 


< text > ——+ 


| 
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a 
[o) 
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a 
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on 
As) 
5 
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ss 
‘a 
2) 
Mm 
“ 
‘Q 
o 
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Ea 
' 
< 
(2) 
~” 
cot 
> 
m 
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ulti-MCS task. The text will be formatted 

put queue. The text may contain carriage 
return, line feed and bell characters which are actioned by the MCP and left in the character string 
passed to the data comm subsystem. 


Example: 
To enter the text ‘“RY S 0”’ to the MCS (usually MSCOBJ) in the mix slot 15, input the following: 
spo input SM 15 RY S 0 
spo output FROM MCS: RY OK (126) 
spo output FROM MCS: STATION 0/AP300XA31 READY (212) 
SM Output Messages: . 


Message Possible Causes Suggested Action 
“SM”? IGNORED — NO There is no MCS having the Use MX to find mix number of 
MCS RUNNING WITH specified mix number. the required MCS. Re-enter SM 
THIS MIX NUMBER. command. 
ENTER ‘‘MX’’? FOR MORE 
DETAILS 
“SM”? INVALID — MIX No mix number was Re-enter SM command with 
NUMBER OF MCS MUST specified. correct mix number. 


BE SPECIFIED. ENTER 
‘MX’? FOR MORE 


DETAILS 

“SM”? IGNORED — NO There is no DC message Wait a short time, then re-enter 
DATACOMM BUFFER space, in which to transfer message. If unsuccessful after 
SPACE AVAILABLE FOR the message text. several attempts, seek technical 
MCS MESSAGE. TRY assistance. 

AGAIN LATER 

“SM”? INVALID — NO The MCS is not running. Check input. Execute the MCS if 
MCS PROGRAM RUNNING required. Re-enter SM. 

“SM”? IGNORED — The MCS was not executed Ensure that the SPO device used 
CANNOT USE COMMAND from this SPO device. is the one that initiated the MCS, 
TO CONTROL PROGRAM or use the SYSTEM SPO device. 
INITIATED BY ANOTHER 

OPERATOR 
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SN (assign a Serial Number to a tape) 


Syntax: 


— SN —— < peripheral > ——— < serial no> ——_ 


This intrinsic is valid for magnetic tape or cassette devices only. It causes the tape to be purged and 
the purge label written to the tape (in a manner similar to the PG intrinsic) will contain the specified 
serial number. 

The serial number is specified as up to five ASCII characters and will appear in all labels written to 
the tape. The serial number remains on the tape when purged. The only way to change the serial num- 
ber is by another explicit SN command. 

The tape may now be written to. 

Ensure that the magnetic tape is write enabled (a write ring is in place on the tape), or that the cassette 
is write enabled (the write tabs on the cassette are set for write enable). The drive must also be ready 
and ‘‘on line’ to the system. 

Examples: 


Example 1. 


To purge a cassette on drive CTB and assign the serial number 12345, input the following: 


spo input SN CTB 12345 
spo output CTB PURGED 12345 
Example 2. 


To purge a magnetic tape on drive MTA and assign the serial number 345, input the following: 


spo input SN MTA 345 
spo output MTA PURGED 345 


SN Output Messages 


Message Possible Causes Suggested Action 
SN faulty input INVALID —_ The specified device is not Check input and ensure with OL 
DEVICE NOT ON SYSTEM. connected to the system. that required drive is connected 
ENTER ‘SOL’? FOR MORE to the system, then re-enter SN. 


DETAILS 


SN faulty input IGNORED The specified peripheral is Check input and re-enter SN. 
— DEVICE MUST NOT BE found to be in use. 

IN USE WHEN COMMAND 

ISSUED. ENTER “‘OL”’ 

AND RETRY WHEN 

DEVICE FREE 
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Message 


SN faulty input FAILED — 
I/O ERROR ON peripheral. 
IF DISK, RUN 
‘““CHECK.DISK’’. IF TAPE, 
REPLACE MEDIA 


SN faulty input IGNORED 
— UNABLE TO PURGE 
WRITE-PROTECTED TAPE 


SN faulty input INVALID — 
DEVICE TYPE NOT 
ALLOWED WITH THIS 
COMMAND. REFER TO 
SOG FOR ALLOWABLE 
FORMATS. 


SN faulty input IGNORED 
— DEVICE ERROR event 
no. ON PERIPHERAL — 
THE REQUESTED 
TRANSLATION TABLE IN 
FILE SYSTRANSLATE 
CANNCT BE ACCESSED 
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(continued) 
Possible Causes 


A hardware error prevented 
the command from being 
executed. 


The peripheral specified in 
an SN command is found to 
be write inhibited. 


An illegal peripheral was 
specified in an FD 
command. 


A problem has been 
encountered in accessing the 
translation table for the 
specified peripheral. 


Suggested Action 


Replace media and try again. If 
the problem continues to occur, 
seek technical assistance. 


Ensure there is write enabied 


media loaded, then re-enter SN. 


Check input and re-enter FD 
command. 


Seek technical assistance. 
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SO PRBK (Set printer backup ON/OFF) 


Syntax: 


—- SO —— PBRK 


< filesize > 


< packid > / 


OFF TO 


This intrinsic is used to change any or all of the following printer backup related options : 


1. The ON/OFF option sets the system printer backup option to the requested state. This allows 
printer output to be directed to a printer or disk backup depending on the options selected by 
the program requiring the printer, and the availability of a printer. If neither option is specified, 
then the state of the system option is not changed. 


2. The disk name option determines the disk on which all printer backup files are to reside. This 
disk must be on the system. This disk name will remain in force until changed by the “‘SO 
PRBK’”’ inirinsic or ihe system is re-warmsiaried (the designated printer backup disk in the fiie 
SYSCONFIG see CONFIGURER). The specification of this option also causes all Printer Back- 
up file opens waiting on a no disk condition to be restarted. If no disk name is given, the print- 
er backup designate disk name is unchanged. 


3. The filesize option specifies the maximum file size to be used when programs open print files 
with their File Parameter Block maximum file size field set to zero. This value must be in the 
range 1 to 999999 and replaces the system default printer backup file size. It remains in force 
until changed by ‘‘SO PRBK”’ intrinsic or the system is re-warmstarted. When the system is 
warmstarted, the default value specified via CONFIGURER is used. 

One of the three options must be present in the initiating message. 
When the option(s) have been updated, the message: 

SO PRBK option(s) COMPLETE 

PRINTER BACKUP OPTION IS ON or OFF 

PB DISK IS packid/ DEFAULT MAXIMUM FILESIZE IS filesize 


is displayed. 


Examples: 
Example 1. 


To enable the system printer backup option the following could be used: 


spo input SO PRBK ON 

spo output SO PRBK ON COMPLETE 

spo output PRINTER BACKUP OPTION IS ON 

spo output PB DISK IS SYSTEM/ DEFAULT MAXIMUM FILESIZE iS filesize 
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NN. 
Example 2. 
To enable the system printer backup option, specify the printer backup designate disk to be 


PBDISK (which is on line and ready) and specify the default printer backup filesize of 10000 records 
(to be used with programs that have a size of zero declared) the following syntax would be used: 


spo input SO PRBK ON TO PBDISK/ 10000 

spo output SO PRBK ON TO PBDISK/ 10000 COMPLETE 

spo output PRINTER BACKUP OPTION IS ON 

spo output PB DISK IS PBDISK/, DEFAULT MAXIMUM FILESIZE IS 10000 
Example 3. 


To disabie the system printer backup option and set the de 


La-1 


fault printer backup designate disk to the 


system, which is named SYSTEM, the following syntax would be used: 


spo input 

spo output 
spo output 
spo output 


SO PRBK OFF TO SYSTEM/ 
SO PRBK OFF TO SYSTEM/ COMPLETE 
PRINTER BACKUP OPTION IS OFF 
PB DISK IS SYSTEM/ DEFAULT MAXIMUM FILESIZE IS 10000 


SO PRBK Output Messages 


Message 


SO faulty input INVALID — 
AT LEAST ONE OPTION 
MUST BE SPECIFIED 
REFER TO SOG 


SO faulty input IGNORED 
— DUPLICATE PRINTER 
BACKUP DISKS ONLINE 
POWER OFF ONE AND 
RETRY COMMAND 


SO faulty input INVALID — 
BACKUP MAXIMUM 
FILESIZE MUST BE IN 
RANGE 1-999999 


SO faulty input IGNORED 
— SPECIFIED PRINTER 
BACKUP DISK NOT 
ONLINE RETRY 
COMMAND WHEN DISK 
ONLINE 


SO faulty input IGNORED 
— ONLY SYSTEM 
OPERATOR MAY ISSUE 
RESTRICTED COMMAND 
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Possible Causes 


The initiating message is not 
correct or none of the three 
possible options was 
specified. 


The disk specified in the SO 
command is a duplicate. 


The filesize specified in the 
SO command is zero or is 
greater than 999999. 


The disk specified in the SO 
command is not present on 
the system. 


This intrinsic can only be 
entered from the controlling 
SPO. 


Suggested Action 
Check input and re-enter SO. 


Power off one of the duplicate 
disks, then re-enter SO. 


Re-enter SO with a valid number 
for the filesize. 


Ensure the required disk is online 
and ready before re-entering SO. 


Re-enter SO from the controlling 
SPO device. 
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ST (Temporarily Suspend a Running Program) 


< mix > 5s a 
/ <progname > 


This intrinsic places a temporary halt on an executing program. The program still appears in the mix. 
The data needed to restart the program exactly where it was stopped may be transferred from memory 
and stored on disk. The memory that was being used by the ‘“‘stopped’’ program will be made available 
if necessary to the MCP for other use. The GO intrinsic must be used to restart the program. 


Syntax: 


— ST 


Examples: 
Example 1. 


To stop the program whose mix number is 3: 


spo input ST 3 
spo output 03/TESTPROG STOPPED 
Example 2. 


To stop the program called OTHERPROG in mix slot 5: 


ST 5/OTHERPROG 
05/OTHERPROG STOPPED 


spo input 
spo output 


ST Output Messages 


Message Possible Cause 


ST faulty input INVALID — 
NO PROGRAM WITH THIS 
MIX NUMBER. ENTER 
“MX’’ FOR MORE 
DETAILS 


ST faulty input INVALID — 
PROGRAM NAME DOES 
NOT MATCH MIX 
NUMBER. ENTER ‘‘MX’’ 
FOR MORE DETAILS 


Suggested Action Action 


Use MX to find the mix number 
of the program requiring device 
assignment. Re-enter ST. 


The mix number does not 
correspond to a program in 
the mix. 


The mix number and 
program name do not 
match. 


Use MX to find the mix number 
and the program name of the 
program requiring device 
assignment. Re-enter ST. 


“ST” IGNORED — 
CANNOT USE COMMAND 
TO CONTROL PROGRAM 
INITIATED BY ANOTHER 
OPERATOR 
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The program was not 
executed from this SPO 
device. 


Ensure that the device used is the 
one that initiated the program or 
use the SYSTEM SPO device. 


SV (Save Peripheral) 


Syntax: 
— sv —— < peripheral > —_—______—_—_| 


Sankle +n all A 1 1 
icable to all devices except disks. 


co 
bo) 
xo 


This intrinsic is a 


This intrinsic allows the operator to logically mark not ready a device in order to prevent its use by 
any program. 


A “saved”? device may be made available (ready) again with the RY intrinsic or by physically powering 
the unit off and then on again. If the device is being used by a program when it is saved, the program 
will be allowed to continue using the device, but any subsequent programs requiring the device will 
be prevented from using it. A saved device may be AD’ed regardless of its physical status. 
Examples: 


Example 1. 


To save the serial printer SPA: 


spo input SV SPA 
spo output SPA SAVED 
Example 2. 


To save the line printer LPA which is being used by a program: 


spo input SV LPA 
spo output LPA SAVED IN USE BY 06/PR060 


SV Output Messages 


Message Possible Causes Suggested Action 
SV faulty input INVALID - The device specified is either Check input and re-enter SV. 
DEVICE TYPE NOT a disk or an illegal 
ALLOWED WITH THIS peripheral. 


COMMAND. REFER TO 
SOG FOR ALLOWABLE 
FORMATS 


SV faulty input INVALID — _ The specified peripheral is Check input and re-enter SV. 
DEVICE NOT ON SYSTEM. not connected to the system. 

ENTER ‘‘OL’’ FOR MORE 

DETAILS 


“SV”? IGNORED — ONLY This intrinsic can only be Re-enter SV from the controlling 
SYSTEM OPERATOR MAY _ entered from the controlling SPO device. 

ISSUE RESTRICTED SPO. 

COMMAND 
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TO PRBK (Test printer backup Option) 


Syntax: 


eo 
PRBK 


This intrinsic is used to interrogate the status of the system printer backup system option. 


When ‘‘TO”’ is entered alone, the system will respond with: PRINTER BACKUP OPTION IS <sta- 
tus>. Where <status> will be either ‘‘ON’’, if the system option is to send to backup if the printer 
is unavailable, or “‘OFF’’ if the system option to use printer backup is not operational. 


When ‘‘TO PRBK”’ is input, in addition to the above information, the system also outputs the fol- 
lowing: 


PB DISK IS <printer backup designate disk 
DEFAULT BACKUP MAXIMUM FILESIZE IS <default filesize in records> 


TO Output Messages 


Message Possible Causes Suggested Action 
TO faulty input INVALID ~_ The only option available is | Check input and re-enter TO. 
OPTION(S) NOT PRBK. 


RECOGNIZED REFER TO 
SOG FOR ALLOWABLE 
FORMAT 
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VF (Vertical Format on Printer, not implemented on B 1000) 


Syntax: 

—— VF Se <c> ,oo <ce> oe <> 
i rill 

Where: 


h — is the page height in lines. 
e — is the end of page line number. 
c — is the channel number. 
n — is the line number. 


This intrinsic applies only to printers which have soft vertical format control. 


This intrinsic allows the operator to define actions to be taken by the printer when certain vertical for- 
mat commands are sent. 

The h field specifies the page height in lines and the optional e ficid specifies the end of page linc 
number. The c field defines the channel number and the n field is the line number corresponding to 


that channel. The channel number and line number fields are optional but when specified they must 
both be present as a pair. The channel number should be 2-11 and page height should not be more 


than 94. 


NOTE 
For further details, see LOAD.VFU utility. 


The following syntax for VF applies to B 9252 line printers. 


— VF — < peripheral > — <h> jaca 


where h and n are defined as above. 


The default form length on B 9252 printers for U.S. and Canadian character sets is 11 inches (27.9 
cm). The default for all other character sets on the B 9252 is 12 inches (30.5 cm). 


NOTE 
LOAD.VFU expects input in a format that is incompatible with B 9252, so 
the LOAD.VFU utility is redundant when B 9252 is in use. 


Examples: 
Example 1. 


To format a soft vertical printer with the following parameters: 
page height = 66 
end of page = 60 
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sn ce en 


channel number 2 corresponds to line 10 


spo input 
spo output 


Example 2. 


VF LPA 66 , 60, 2 10 
VF LPA 66 , 60 , 2 10 COMPLETE 


To format a B 9252 printer with the following parameters: 


page height = 66 
line number = 10 


spo input 
spo output 


VF Output Messages 


Message 


VF faulty input INVALID — 
PARAMETERS ILLEGAL 
OR OUT OF RANGE. 
REFER TO SOG FOR 
ALLOWABLE FORMAT 


“VF”? IGNORED — 
peripheral NOT READY. 
POWER ON PRINTER OR 
USE “RY”? TO BRING ON 
LINE. 


VF faulty input IGNORED 
— DEVICE MUST NOT BE 
IN USE WHEN COMMAND 
ISSUED. ENTER ‘‘OL’’ 
AND RETRY WHEN 
DEVICE FREE 


“VF”? IGNORED — 
peripheral DOES NOT HAVE 
SOFT VFU CAPABILITY 
AND CANNOT BE 
LOADED WITH FORMAT 
DATA. REFER TO SOG 
FOR MORE DETAILS 


“VF”? IGNORED — ONLY 
SYSTEM OPERATOR MAY 
ISSUE RESTRICTED 
COMMAND 


VF IGNORED — DEVICE 
ERROR event no. ON 
peripheral -— THE LP 
TRANSLATION TABLE text 
SPECIFIED IN THE 
SYSCONFIG FILE CANNOT 
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VF LPA 66 , 10 
VF LPA 66 , 10, COMPLETE 


Possible Causes 


Typing error in initiating 
message. 


The specified peripheral is 
not ready. 


The specified peripheral is 
being used by a program. 


The specified peripheral is 
not capable of doing soft 
vertical formatting. 


This intrinsic can only be 
entered from the controlling 
SPO. 


The line printer translation 
table for the specified 
peripheral cannot be found. 


Suggested Action 
Check input and re-enter VF. 


Ensure that the peripheral is 
connected to the system and 
ready. 


Wait until the program has 
finished with the peripheral, then 
re-enter VFU. 


None. 


Re-enter VF from the controlling 
SPO device. 


Seek technical assistance. 


oe 


Message 
BE LOCATED IN FILE 
SYSTRANSLATE 


VF IGNORED — DEVICE 
ERROR event no. ON 
peripheral — THE 
REQUESTED 
TRANSLATION TABLE IN 
FILE SYSTRANSLATE 
CANNOT BE ACCESSED 
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(continued) 
Possible Causes Suggested Action 
A problem has been Seek technical assistance. 


encountered in accessing the 
translation table for the 
specified peripheral. 
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- SECTION 4 
CMS-COMMON UTILITIES 


INTRODUCTION 


This section describes all standard CMS utilities that form part of a CMS system software release. The 
applicability of any utility depends on the type of hardware availabie. For example, utilities requiring 
console files cannot be executed on machines without a console: as an example, CREATE, AMEND, 
FL and UPDATE cannot be run on a B 900 or B 1900. 


Table 4-1 gives a list of all required peripherals for each utility. In this table, required peripherals are 
denoted by the letter ‘‘R’’, and optional peripherals by the letter ‘OQ’. One asterisk (‘‘*’’) indicates 
that out of all the options, at least one is required. In particular, those utilities requiring a line printer 
may use a console printer by default if the line printer is not present on the system. Two asterisks 
(‘“**”’) indicate that out of all the options, at least two are required. 


STAR FILES 


The star-file facility permits the initiating message parameters of most utilities to be specified on a disk 
file which is referenced in the initiating message. 


The utilities which do not support this feature are: 


FILEUTL — File Maintenance Utility 
CP — Compute 

DA — Disk Analysis 

KEY.CHECK — Key Validity 

XD — Delete Bad Disk Sectors 
PPID — Pseudo-Pack Identifier 

WL —- Which Log 


as well as the following B 90-only utilities: 


COLDSTART 

INSTALL 

GEN.DUMPFL — Create empty B 90 Memory Dump File 
PATCHMAKER — Patch B 90 machine code, and object program files 
CONFIGURER — Configure B 90 System Software 

BUILDTRANS — Build Translation Table 


CO supports a star-file facility which is slightly different from the general utility star-file facility. Refer 
to CO, Section 6, for details. 


The syntax (as inserted in the initiating message) is: 


* < disk-id > / < file-id > 


The utilities which support the star-file feature have the limitation of 400 significant characters within 
their initiating message. (The initiating message for LD may be up to 600 significant characters in 
length.) 


2032801 44 


Table 4-1. Peripherals Required by CMS-Common Utilities 


ae ‘ i Terminal Printer i 
Utilit 3 Serial | ser. Line Card | Card | Paper 
ii ese ee 
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aa 


Star files may contain any number of records, with any record size. A single space is considered a 
significant character, and any double: space encountered is considered to be a single space (and hence 
only one significant character). Spaces at either end of the message are ignored. 


Where star files are a feature of a particular utility, the star file may be placed at any point in the 
initiating message after the utility name. The initiating message may contain any number of star files 
but these may not be nested: that is, the information within a star file must not contain a call on 
any other star file. 


If the specified file cannot be found, an “UNABLE TO ACCESS STAR FILE <file-name>’”’ message 
is displayed by the utility. 


Examples 


1. RM *M101A/RMFILE 
where RMFILE is a disk file on disk M101A containing one record with the contents REP200, 
REPS562, RQ=, RCOPY 


2. DA *DISK1/F 
where F is a file containing a list of filenames. 


3. COPY *DISK2/B 
where B is a file containing the remainder of the initiating message — “FILEA <BOTH> 


Ferre SENET OD 


TO DISK3/FILES” 


SYS-SUPERUTL 
This system utility provides the following functions: 


CH — change the name of a file or a group of files 
KX — interrogate disk space 

PD — interrogate disk directory 

RM — remove a file or group of files 

IR — initiate recall of SPO log messages 

LB — look back in SPO log 

LF — look forward in SPO log 


It executes automatically if the program file is on the systems disk when one of these functions is re- 
quired. This program is also automatically executed at warmstart time and co-ordinates logging func- 
tions at that time. 


SYS-SUPERUTL supports the following filetypes: 


Filetype Description 
00 Normal Data 
01-0E Source Language 
OF Source Library 
10-12 Normal Code 
13 Protected Code 
14-16 Interpreter/SORTINTRINS/MCPX/SAU 
21 SYSLANGUAGE local language 
22 SYSCONFIG — a required file 
30 Virtual Memory/Dump 
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(continued) 
Filetype Description 
31 System Log 
40-41 MPLII Compiler Work 
81 Key 
AO Printer Backup 


Of these, the following filetypes are system files: 


13 Protected Code 
14-16 Interpreter/SORTINTRINS/MCPX/SAU 
21 SYSLANGUAGE local language 
22 SYSCONFIG 
30 Virtual Memory/Dump 
31 System Log 


A request for the removal of a system file causes the RM utility to output 


<file-name> IS A SYSTEM FILE 
<mix-no>/RM REQUIRES DATA. USE “‘AX” 


Then, to remove a system file: 
AX <mix-no> OK 


The utility has some features which can cause the operator confusion. The utility does not appear in 
the response to the MX command unless it is actually performing one of its functions, when it appears 
as 27/PD or 27/CH etc., according to the function which it is currently performing. If an attempt 
is made to execute one of the SYS-SUPERUTL functions when it is already busy, then a response of 


PROGRAM LOAD FAILURE <64> 

<function> WILL NOT RUN — 

SUPERUTILITY FUNCTION ALREADY RUNNING 
is returned. 


SYSLANGUAGE 


All CMS utilities which output SPO messages, with the exception of PATCHMAKER, GEN- 
-DUMPFL, and SYCOPY, display these messages from a common SYSLANGUAGE file. THIS FILE 
MUST BE PRESENT IN ORDER FOR ANY OF THE UTILITIES USING IT TO EXECUTE. Asso- 
ciated with this file is the message: 


““<utility name> CANNOT DISPLAY MESSAGE <entry no> 
~ THE MESSAGE IS NOT PRESENT IN THE LANGUAGE DICTIONARY FOR THIS SYS- 
TEM’”’ 


which denotes that the utility executing has attempted to display a message which is not contained in 
the dictionary file SYSLANGUAGE. 


NOTE 
FILEUTL also uses a file called SYS.FILEUTL for screen layout informa- 
tion. 
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PSEUDO-PACKS 


Pseudo-packs allow fixed disk units containing multiple disk platters to be handled as one large contig- 
uous disk. This enables the MCP to address the space on all disk platters as one large available area. 


The disk structure that makes this possible is the Pseudo-Pack Identifier Table (PPIT) and is only rele- 
vant to fixed disk directories. The fixed disk directory generated at disk initialization for systems using 


a iat art 
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pseudo-packs consists of four parts: 
1. The name list. 

2. The disk file headers for each file. 

3. The available table. 

4. The Pseudo-Pack Identifier Table (PPIT). 


The relationship between these parts is shown in figure 4-1. 


TRACK K LABEL 
ZERO DISK LA 


PSEUDO-PACK 
DIRECT- AVAILABLE DISK FILE IDENTIFIER 


ORY TABLE HEADERS TABLE 


DISK 
SPACE 
FOR 
FILES 


Figure 4-1. Fixed Disk Directory Structure 


The available table and disk file headers generated at initialization time have entries which reflect the 
logical structure of the entire disk unit. 


The name list now contains a list of each file on the entire disk unit and a unique identifier, which 
is used to distinguish files contained on one pseudo-pack from files contained on another pseudo-pack. 


The PPIT is a list of all the pseudo-packs declared on the system. An identical PPIT exists on each 
fixed disk unit. 
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The ADD PACK intrinsic enables the operator to declare a new pseudo-pack to the system. It also 
allows the operator to declare the pseudo-pack as restricted or unrestricted. Once a pseudo-pack has 
been declared restricted or unrestricted, this designation cannot be changed. 


When a new file is created on an unrestricted pseudo-pack, areas for the file may be allocated on any 
of the fixed disks. When a file is created on a restricted pseudo-pack (or with physical unit pack-id), 
areas for the file are allocated only on the designated unit. 


When searching for a file on an unrestricted pseudo-pack, the PPIT and file directories on all fixed 
disk units are searched, otherwise, only the PPIT and file directory on the designated unit are searched. 


The Pseudo-Pack Identifier Display (PPID) utility allows the operator to list the Pseudo-Pack Identifier 
Table on the operator display terminal (ODT) or line printer. 


NOTE 
Pseudo packs are currently implemented only on B 900 systems. 


LOGGING IN THE 3.05 RELEASE 


There are two possible types of information which may require to be logged by the MCP. These are 
maintenance information entries and, if requested, System message entries (SCL 


= 


Nowe 


Maintenance log entries are used by Field Engineering personnel to assess the performance of all pe- 
ripherals attached to the system. They provide information on the device usage and on any I/O failures 
which require corrective action to be taken by the system. Maintenance logging will always be present 
on the system and cannot be stopped and restarted by the user. 


System message logging is a method of providing a log of all SCL input and output and is used as 
a tool in the diagnosis of software failures. It can also provide a hard copy record of system activity 
for systems using a SELF-SCAN or terminal type SPO device. 


Logging in the 3.05 release functions in the following manner. 


There are four files called primary log files into which the MCP will temporarily store maintenance 
entries, and, if required, any system message entries. The primary log files are used as illustrated in 
the following diagram: 

if required, any system message entries. The primary log files are used as illustrated in 


the following diagram: <tie 1 > . <file 2> 


Y 


< file 4 > ——— ee < file 3> 


Once a log file has been filled, the next file in the sequence is used. When all four primary log files 
have been filled, the sequence restarts and the first primary log file will be overwritten by any subse- 
quent log information. 


This form of log file usage is called CYCLIC. 


At the point where a primary log file has been filled and the MCP begins to route the log information 
to the next primary log file in the cycle, the TL utility is invoked. This utility will save the contents 
of a primary log file to prevent the loss of log information when that primary log file is marked as 
“NEXT ACTIVE” and cleared for use by the MCP. 
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The maintenance entries are transferred into log file(s) called secondary log files(s). These files are 
NON-CYCLIC. That is, as each secondary log file is filled, the progression number in the file name 
of the secondary log file is incremented and a new file in the series is created and used. 


If the system message logging option is set in the system configuration file (SYSCONFIG), there are 
two possible forms which may be adopted. The action taken by the TL utility is affected by which 
of the two forms has been requested. 


The two forms of system message logging are: 


1. CYCLIC system message logging. This occurs when the MCP places system messages in the 
primary log files only. The system messages are not transferred to NON-CYCLIC secondary 
log files when the primary file is filled. This form provides full system message logging back 
to the point where the primary files have been overwritten. 


2. NON-CYCLIC system message logging. This form of system message logging treats system mes- 
sage entries in a manner similar to maintenance log entries. Each entry will then be preserved 
in a secondary log file by the TL utility at the point where a change of primary log file is re- 
quired. 


The following paragraphs describe the different aspects of logging in greater detail. 


Types of Log File 


Primary: 
SYS-LOG-01 These files are created at warmstart by SYS-SUPERUTL, if they are not 
SYS-LOG-02 already present, and are written to and maintained by the MCP. 
SYS-LOG-03 They each contain a hardware configuration entry and maintenance entries. 
SYS-LOG-04 System messages (if requested in CONFIGURER <SYSCONFIG>) are written 
to these files in a cyclic manner by the MCP. 
Secondary: 


SYS-MLGjjjmm Contains maintenance entries which have been transferred by TL from a ready 
to transfer primary log-file. Used in both cyclic and non-cyclic System message 
logging. 

SYS-HLDjjjnn Contains system messages transferred by TL from a ready to transfer primary 
log file. Used in non-cyclic system message logging. 

SYS-LOG- Contains system message entries from the primary log files which, at 

HOLD warmstart, were found to contain maintenance entries not transferred by TL to 
any secondary log file in the previous session of usage. This file is only used 
with cyclic system message logging. 

Where jij is the Julian date 
and nn and mm are progression numbers in the range 00-99. 


The secondary log files are created and maintained by the TL utility. The SYS-LOG-HOLD file will 
be recreated each time it is used. Both SYS-HLDjjjnn and SYS-MLGjjjmm are non-cyclic in nature, 
that is, when TL is adding entries to either of these files and finds that the file is full, it increments 
the respective progression number in SYSCONFIG and creates a new file with the new progression 
number. The TL utility will then continue using the newly created file. 


Types of Logging 


Maintenance logging is always active on the system. The four primary logs will always be present along 
with SYS-MLGijjjmm file(s). It is only if SPO logging has been requested via a CONFIGURER option 
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that system message entries are placed in the primary log files by the MCP. The exception is when 
a console SELF-SCAN is to be used as an SCL device since, in this case, system messages will always 
be logged. Maintenance logging functions in a NON-CYCLIC fashion only because it is very important 
that the data is not lost. 


CYCLIC System Message Logging 


The four primary log files are used with SYS-MLGjjjmm in this mode. At warmstart, TL is zipped 
and locates the primary log file(s) which have not had their maintenance entries transferred during the 
previous session. TL then transfers the maintenance entries from these primary log files into the current 
SYS-MLGjjjmm file, as well as transferring the system message entries to a file called SYS-LOG- 
HOLD. 


The MCP now starts using SYS-LOG-01. 


When a primary log file becomes full, TL is zipped to transfer the maintenance entries from this pri- 
mary log file to the current SYS-MLGjjjmm file. The system message entries are left in the primary 
log file. 


NOTE 


While the MCP is writing to a primary log file, the next primary log file in 
the series is cleared by the MCP ready for use. For example, if the MCP is 
using SYS-LOG-01, then SYS-LOG-02 is denoted as NEXT ACTIVE and the 
MCP clears it for use. 


When the MCP starts using SYS-LOG-04, SYS-LOG-01 will be cleared ready 
for use. Therefore, if the size of the primary log files is small in comparison 
with the number of system messages and maintenance entries, system message 
and maintenance entries will be overwritten by the MCP. Maintenance entries 
are preserved in SYS-MLGijjjmm secondary log file(s). 


NON-CYCLIC System Message Logging 


The four primary log files along with SYS-MLGjjjmm and SYS-HLDjjjnn are used in this mode. At 
warmstart, TL is zipped and transfers all the maintenance entries from the primary log file(s) which 
have not been transferred in the previous session to the current SYS-HLDjjjmm. TL also transfers all 
the System messages from this primary log file into the current SYS-HLDjjjnn. 


The MCP will now start using SYS-LOG-01. 


As each primary log file is filled, TL is zipped to transfer maintenance entries from this primary log 
file to the current SYS-MLGjjjmm. TL also transfers the system messages from this primary log file 
to the current SYS-HLDjjjnn. Therefore, system messages are preserved along with maintenance entries 
in their respective secondary log files, SYS-HLDjjjnn and SYS-MLGjjjmm. 


Intrinsics and Utilities Linked with Logging 


The intrinsics and utilities which are connected with the logging function of the system fall into two 
distinct categories. There are certain utilities which are directly involved in the creation, maintenance 
and control of the log files and the data recorded within them. There are also utilities which allow 
the operator to access the contents of the log files. The following is a list, in alphabetic order, of intrin- 
sics and utilities linked with logging. 


CONFIGURER 
[U] 


IR [S] 


LB [{S] 
LF [S] 
LG [M] 
LS [M] 


PL [U} 


SYS-SUPERUTL 


TL [U] 


WL [U] 


Allows the following control over logging: 

1. If system message logging is required, note that maintenance logging is 
always ON. 

2. The choice of CYCLIC or NON-CYCLIC system message logging. 

3. The size of the primary log files (that is, SYS-LOG-01 to 04). 

4. The size of the secondary system message file (that is, SYS-HLDjjjnn). 

5. The size of the secondary maintenance entry file (that is, SYS-MLGjjjmm). 
6. The name of the disk where the secondary log files are to reside. 

This information is stored in the file called SYSCONFIG. 


Initiates recall of system message entries to a SPO capable device. Only system 
message entries from primary log files which have not been transferred by the 
TL utility may be accessed. IR also enables the use of LF (Look Forward) 
and LB (Look Back) functions. IR, LB or LF will be terminated when any 
other SYS-SUPERUTL function is invoked. 


Will cause the display of system message entries from a point further back in 
the primary log files than the last entries to be displayed to the SPO. 

Will cause the display of system message entries from a point further forward 
in the primary log file than the last entries to be displayed to the SPO. 
Starts logging, that is, the MCP begins writing system message entries to the 
primary log files. 

Stops logging, that is, the MCP stops writing system message entries into the 
primary log files. 

Permits the printing of a log file, in full or in part, over a given time 
interval. It also allows the option of automatically removing the printed log 
file. 


Creates the four primary log files, if they are not present at warmstart. The 
MCP then writes maintenance entries and, if requested, also system messages 
into the primary log files. 


Creates and maintains secondary log files when required (TL is ZIPped by the 
MCP automatically). 


Displays the current state of the primary log files and the active secondary log 
files. 


NOTE 


Items marked [M] are MCP intrinsics and full details of their use are in- 
cluded in section 3 CMS Common Intrinsics. 


Items marked [U] are utilities and full details of their use are given under 
CMS Common Utilities later in this section. 


Items marked [S] are functions of SYS-SUPERUTL, full details of their use 
are given under CMS Common Utilities later in this section. 


Suggested Logging Method 


The suggested logging method, described below, ensures that no system message is “‘lost’’ due to over- 
writing of the primary log files (as these files are cyclic in nature). 


To set up the parameters required, configurer needs to be run and the following changes made to SYS- 


COMFIG: 
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1. SPO logging must be switched ON. 

2. NON-CYCLIC logging is required. 

3. The sizes of the primary and secondary log files will have to be determined by usage for effi- 
cient use of logging. A suggested size for the secondary system message log files on a fixed 
disk based system is 400 sectors. All other log file sizes are left at the default values. 

4, The backup disk for log files should be left as the system disk. 


The following logging procedure should be adopted: 


1. At warmstart, the operator should execute a PD of the secondary log file family names to find 
out which log files are present. The following syntax is recommended for PD: 


PD SYS-HLD=, SYS-MLG= 


NOTE 
The files with the family prefix SYS-HLD contain the system message entries 
and the files with the family prefix SYS-MLG contain the maintenance en- 
tries. 


2. The operator then prints the system message and maintenance log files, if required, using 
the following syntax. 


< file-name > PURGE 


Where: <file-name> is the log which is required 


PL 


PURGE will remove the secondary log file after it has been printed. 
See PL utility for other options. 


If the above procedure is followed during every warmstart with the PURGE option in the initiating 
message of PL (for all the SYS-HLDjjjnn and SYS-MLGjjjmm), the user should have only the current 
session’s log files on the system. 


Log File Sizes 
The size of the log files required depends on several factors. 


To minimize operator activity in printing log files, for NON-CYCLIC logging, the size of the secondary 
log file should be large enough to hold a full day’s system messages. Similarly, the size of the mainte- 
nance log files for both CYCLIC and NON-CYCLIC modes should be large enough to hold a full 
day’s entries. Under normal circumstances (that is, unless a hardware problem exists on the system), 
the number of maintenance entries will be small. 


In this way, only two files will be created per day for NON-CYCLIC logging. If the system disk space 
is limited, the secondary log files can be directed to a user disk. Also, the size of the primary log files 
can be kept to a minimum. However, the smaller the primary log files, the more often TL will be 
zipped to transfer entries to the secondary files. Frequent use of TL may adversely affect system re- 
sponse time. The length of time taken to transfer entries is proportional to the size of the primary 
log files. 
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If the system is warmstarted daily and system disk space is not critical, the primary log files can be 
made large enough to ensure that they are never filled. In this way TL will only be zipped at warmstart 
and no interruption to the system will occur during normal use. 


In order to calculate the required file size in sectors, the following algorithm is suggested: 


AVG.msgs. 2 
(TOT.msgs.2 x =<) 
TOT.size = TOT.msgs.1 + 32 
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TOT.size = total number of sectors to hold all system messages 
TOT.msgs.1 = total number of messages shorter than 33 bytes 
TOT.msgs.2 = total number of messages longer than 32 bytes 
AVG.msgs.2 = average length of messages longer than 32 bytes 


TOT.size should then be increased by 10 percent to allow for fluctutations in system usage. 


NOTE 
The total number of messages produced by a system can be determined by 
examining the system log files on a day of heavy activity. 


ARCHIVING USING UPDATE FACILITY 


By using the keyword UPDATED in the initiating message of LD or DUMPADISK, the operator may 


choose to have only updated or newly created files dumped without having to identify such files by 
name. 


This is possible from the 3.04 release onwards, as the UPDATED bit in the Disk File Header (DFH) 
has been implemented (see the MCP Reference Manual, form number 2007555). When a disk file is 
successfully written to, the MCP sets the UPDATED bit in the DFH of that file. The DFHs of both 
related Key and Data files of indexed pairs are handled together. This ensures that a Key file will be 
marked updated along with its Data file on a successful rewrite, overwrite, add or delete. 


Any new or updated file therefore has its UPDATED bit set automatically. The UPDATED bit is reset 
when a file is successfully backed-up by one of the following utilities: LD (DUMP and UNLOAD), 
CHECKADUMP, and DUMPADISK. 

If DUMP & CHECK is requested, LD does not itself reset the UPDATED bit. Instead, CHECKA- 
DUMP resets the UPDATED bit in the DFH of any file that compares successfully. If CHECKA- 
DUMP is initiated other than being zipped by LD, then it does not alter the UPDATED bits. 


The B 90 Stand Alone Utility (SAU) does not alter the UPDATED bit when copying files. The setting 
of the UPDATED bit will therefore be identical in both the old and new copies of the file. 


The B 90 COLDSTART utility always resets the UPDATED bit in the DFHs of files it loads. All other 
utilities set the UPDATED bit when they create or write to a file. 


The LR utility includes the setting of the UPDATED bit in its printout. 
The following is an example of a simple Archiving System, assuming a five day working week, 
1. On each day, Monday through Thursday, only updated files are dumped. 
The initiating message for dumping to tape is: 
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LD DUMP & CHECK UPDATED PRINT.DIR FROM <disk-name> TO <tape- 
name> = 


The initiating message for dumping to disk is: 
DUMPADISK PRINT.DIR DUMP UPDATED FROM <disk-name> = 


2. On Friday, all files are dumped. 


The initiating message for dumping to tape is: 
LD DUMP & CHECK PRINT.DIR FROM <disk-name> TO <tape-name> = 


The initiating message for dumping to disk is: 
DUMPADISK PRINT.DIR DUMP FROM <disk-name> = 


These five tapes/disks could be recycled weekly, or kept for as long as thought necessary. 


Assuming that the tapes/disks are recycled weekly, and a disk is lost and must be rebuilt, the following 
recovery procedure could be used: 


1. Initialize the disk in question — <disk-name-user>. 


2. Working backwards from the previous day’s backup tape/disk to the last full dump tape/disk 
(the previous Friday). 


The initiating message to load back from tape is: 
LD ADD PRINT.DIR TO <disk-name-user> FROM <tape-name> = 


Example: 


Assume daily tapes are called MONDLY, TUEDLY, WEDDLY and THURDLY. 
Assume weekly tape is called FRIWKLY. 


1. If the failure occurs on a Monday, then: 


1) Initialize <disk-name-user >. 
2) ADD PRINT.DIR FROM FRIWKLY TO <disk-name-user> = 


2. If the failure occurs on a Thursday, then: 


1) Initialize <disk-name-user>. 

2) ADD PRINT.DIR FROM WEDDLY TO <disk-name-user> = 
ADD PRINT.DIR FROM TUEDLY TO <disk-name-user> = 
ADD PRINT.DIR FROM MONDLY TO <disk-name-user> = 
ADD PRINT.DIR FROM FRIWKLY TO <disk-name-user> = 


Once the disk has been rebuilt in this way using LD or DUMPADISK, all of the UPDATED bits will 
be set. This results in all of the files being dumped next time a DUMP UPDATED is requested. To 


reset the UPDATED bits, it is necessary to re-dump all the files. 


NOTE 
The specification of PRINT.DIR in the initiating messages of LD and DUM- 
PADISK causes an accurate directory to be printed. 


See LD utility and DUMPADISK utility for the full syntax. 
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COMMON UTILITY OUTPUT MESSAGES 


Message 


INCORRECT INPUT TO 
< utility-name > 


-INVALID CHARACTER 
IN <file-name> 


—FILE NOT FOUND 


—FILE IS CURRENTLY 
BEING USED 


— REQUEST IS 
INCOMPLETE 


—DISK <disk-name> IS 
NOT ON LINE 
INCORRECT INPUT TO 
<program name> 
<character string 


CANNOT RUN <utility 
name> 


UNABLE TO CONTINUE 
WITH <utility name> 


—FILE IS NOT A SOURCE 
OR A DATA FILE 


—CANNOT HANDLE A 
REQUEST OF THIS 
LENGTH © 


— REQUESTED FILES 
WERE NOT FOUND 


— DISK <disk-id> IS 
CURRENTLY LOCKED BY 
ANOTHER PROGRAM. 


—SYSTEM DISK IS 
CURRENTLY LOCKED BY 
ANOTHER PROGRAM. 
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Possible Causes 


The input to the specified 
utility is wrong. The second 
message given explains the 
type of error. 


Disk name or file name 
contains characters(s) not 
permitted by the system. 
Valid characters are: A-Z, 0- 
9, . (dot), — (dash). 


Specified file name is not on 
the disk. 


Specified file is being used 
by another program. 


Input message is incomplete. 


Specified disk is not on-line 
to computer. 


Input message is incomplete 
or incorrect. 


The utility cannot run. The 
reason is given in the next 
error message displayed. 


The utility cannot continue. 
The reason is given in the 
second message displayed. 


The file requested must be 
file type source or data 
@00@-@0F@. 


The initiating message is too 
long. 


The specified files are not in 
the directory of the specified 
disk. 


Another program has opened 
the specified disks SYSMEM 
with lock. 


Another program has opened 
the system disks SYSMEM 
with lock. 


Suggested Action 


Look for type of error in the 
second message displayed by the 
utility. 


Correct input and re-enter. 


Check input for correct file and 
disk name. 


Re-enter when other program 
has stopped using the file. 


Check input and re-enter. 


Make disk available. ‘‘RY”’ 
drive. 


Check input and re-enter. 


None. 


Look for reason in the second 
message displayed by the utility. 


Check file and re-enter. 


Check input and re-enter. 


Check input for correct file 
names. 


Wait for the other program to 
go to end-of-job. 


Wait for the other program to 
go to end-of-job. 
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Message 


FILENAME < filename > 
EXCEEDS 12 
CHARACTERS 


—UNABLE TO ACCESS 
STAR FILE <filename> 


—DISKNAME <diskname> 
EXCEEDS 7 CHARACTERS 


—UNABLE TO ACCESS 
STAR FILE <filename> 
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(continued) 
Possible Causes . 


The specified filename is too 
long. 


The specified file is either 
not on disk or is in use. 


The specified diskname is too 
long. , 


The specified file is not in 
the directory of the specified 
disk. 


Suggested Action 
Correct input and re-enter. 
Make file available and re-enter. 
Correct input and re-enter. 


Check input for correct file 
name. 


ADD (ADD FROM LIBRARY TAPE TO DISK) 
(LD — TAPE UTILITY) 


This function is part of the utility LD. ADD provides the capability of copying files or groups of files, 
which do not already exist on the disk, from a library tape to the disk specified by disk-name, or if 
no disk-name is specified, to the system disk. 


os ee ee PRINT DIR FROM 


< tape-name > —_-> 


< file-name > 
< disk-name > 


< family-name > 
PRINT.DIR If PRINT.DIR is specified, a printout of all the files loaded will be 
produced at the end of the ADD. 
When PRINT.DIR is specified, the message 
‘‘<file-name> LOADED”’ 
will be suppressed. 
Displays will be limited to exception conditions, that is, if a file is 
not loaded for some reason. 


FROM <tape-name> This is the name of the tape from which the files are to be loaded. 


TO <disk-name> If the TO option is specified, the name of the disk to which the 
files are to be loaded must be given. If the TO option is not used, 
then the files will be loaded on io the system disk. 


<file-name> <family- This is the file or family of files to be added to the disk. Groups 

name> of files may be added by separating the file names or family names 
by a comma “‘,’’. 

<BOTH> If <BOTH> is specified immediately following a request to load a 


key file then, provided that the pertinent data file does not precede 
the key file on the library tape, the data file will also be loaded and 
a suitable amendment will be made to the key file so that it points 
to the disk which now holds the data file (rather than the disk from 
which the data file was dumped). 


Since the ADD function is part of the utility LD, ‘‘LD’’ is actually what appears in a mix message. 
To discontinue the ADD function, ‘‘DS <mix-number>/LD”’’ must be used. 


Examples 

Example 1. To copy all the files which are not already present from the tape named 
UPDATE to the system disk, the following syntax is used: 
LD ADD FROM UPDATE = 


Example 2. To copy the keyfile named QUARCK and its associated data file from the 
tape called QACK to the disk called Q3, the following syntax is used: 


LD ADD FROM QACK TO Q3 QUARCK <BOTH> 
Example 3. To copy all the files from the tape called BACKUP in the family JOB., 
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“which do not already exist on the disk DISK1, the following syntax is 
used: 


LD ADD PRINT.DIR FROM BACKUP TO DISK! JOB. = 


With the addition of the option PRINT.DIR, a printout of all the files 
which ADD loaded will be produced. 


Output Messages 


For ADD output messages, refer to LD utility. 
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AMEND (Disk File Amending — Applicable to B90 Only) 


This utility is used to modify records within an existing data or source file. The CREATE and UP- 
DATE utilities use many similar features. It is only available for use on systems which have console 
files. The utility supports the star-file feature. If a file is AMENDed, the generation number of the 
file is incremented by one. 


Format: 


6 < disk-name > <= / ] 
AMEND - < filename > 


Input may be either alphanumeric (A) or hexadecimal (N) (see CREATE for details). The default is 
A. 


Entering TABSTOP in the initiating message causes AMEND to set up TAB positions coinciding with 
the end of the console line as well as any other tabs specified. Tabs must be used with AMEND, de- 
spite the fact that no new records are being entered. 


manually selected tabs may still be used. The end-of-console line-tabs (depending on record size and 
file-type) are as follows: 


Source or Data alphanumeric : 111 221 331 441 
Data Hexadecimal : 56 111 166 221 276 331 386 441 496 


These tab positions are the same as those set for CREATE with regard to record input, although 
AMEND has no facility to input new records. 


Examples: 

Tabs Set at: 
AMEND FILEA TABSTOP 111 221 331 
AMEND FILEB A TABSTOP 51 61 221 51 61 1i1 221 331 441 
AMEND FILEC N TABSTOP 56 111 166 221 276 331 386 441 


In these examples, 
FILEA is a sourcefile with a record size of 410, 
FILEB is a datafile with a record size of 500, 
FILEC is a datafile with a record size of 450. 
The ‘“‘number’”’ option may be used to set tab positions for character input (see CREATE for details). 


The utility operates in two modes: ‘‘Record Modify’? (PK2) and “Record Select’? (PK3). 
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PKI PK2 PK3 PK4 PKS PK6 


NEXT MODIFY SELECT - _ END 
An OCK4 ‘‘help’’ option is provided, which will output the above options when pressed in either Mod- 
ify or Select mode. In order to show which mode the utility was in when OCK4 was pressed, an asterisk 
(*) is printed next to that mode on the Help display. 


PK1 is used to select the next sequential record in the file to be printed. The use of PK1 terminates 
“Record Modify’’ and ‘‘Record Select’? modes, therefore a re-selection of mode must be made before 
continuing. 


If PK3 (‘‘Record Select”? mode) is used, the required record is identified by logical record number using 
this format: 


RECORD 
eee anal |S < number > — 


The ‘‘number’’ may take any value from 1 to the number of records in the file. 
PK2 is used to make corrections to existing records. This PK operates as PK2 in CREATE utility. 
The point in the record at which alterations are to be made is selected by typing an identifying group 
of characters immediately preceding the bytes(s) of the record to be altered. The portion of the record 
to be replaced or inserted follows the identifying characters, delimited by a colon (:). If alterations 
are to be made at the beginning of the record, no identifying characters are necessary. A starting byte 
position for the identifying character string search can be specified in the console input. 
Example: 
To amend a source file called MYFILE, record size 40 bytes, tab set at 5, 10, 15, 20: 

AMEND MYFILE 5 10 15 20 


First select a record by pressing PK3, and then enter ‘‘20’’ for logical record 20 in MYFILE. The utility 
selects and prints the contents of record 20: 


20 ABCDEFGHIJKLMNOPQRST 

To replace characters, press PK2 and type the replacement 
D : ZZZZ : OCK1 

resulting in ‘‘20 ABCDZZZZIJKLMNOPQRST”’ 

Or if insertion of characters is desired, type the characters to be inserted into the record: 
Z: XXXXXKX : OCK2 


resulting in “‘20 ABCDZXXXXXXZZZOPQRST”’ 


NOTE 
The insertion from character six to eleven will result in the shifting of charac- 
ters ‘““ZZZIJKLMN”’ from byte position 12 to the boundary of the next tab 
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position, which is 15. Therefore only 3 characters ‘‘ZZZ’’ are shifted from 
12 to 14 and ‘“‘IJKLMN’’ are lost. The text from the next tab position 15 
onwards is not affected. 


Starting Byte for Modification 
A starting byte can be specified for the modification of a record. 


If both the identifying string and the start position are specified, the utility scans from the start posi- 
tion for that identifying string. The portion of the record before the start position is ignored. If that 
identifying string does not exist, ‘BYTE WITHIN RECORD SPECIFIED NOT FOUND” is displayed 
and the utility then awaits re-input. 


Format: 


identifying string : amending character string : start position 
or 
amending character string : start position 
or 
identifying string : amending character string : 


Example: 


Rec. No. Contents of Record 


AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCC DDDDDEEEEE 
AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 


NAAM hWN 


1. This first example illustrates the modification of each record by replacement. 
Enter: ‘‘AMEND FILEA”’ 
The following is displayed: 
2?DATA AMEND 


PK1 PK2 *PK3 PK6 
NEXT MODIFY SELECT END 


Press PK1. This causes the next record to be displayed (in this case, the first): 
1 AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
Enter the amending command and press OCK1 (for replacement): 


BBBBB:XXXXX: and terminate with OCKI1. 
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AMEND now displays the AMENDed record: 
1 AAAAABBBBBXKXKXXDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
Press PK1. 


2 AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
<XXXXX:11 (OCK1) 
2 AAAAABBBBBXXXXXDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
Press PK 1 
3 AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
BBBBB:XXXXX:2 (OCK1) 
3 AAAAABBBBBXXXXXDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
Press PK] 
4. AAAAABBBBBCCCCCDDDDD AAAAABBBBB CCCCCDDDDDEEEEE 
4 AAAAABBBBBCCCCCDDDDD AAAAABBBBBXXXXXDDDDDEEEEE 
Press PK1 
5 AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
>XXXXX:31 (OCKI) 
5 AAAAABBBBBCCCCCDDDDD AAAAABBBBBXXXXXDDDDDEEEREE 
Press PK1 
6 AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
BBBBB:XXXXX:7 (OCK1) 
6 AAAAABBBBBCCCCCDDDDD AAAAABBBBBXXXXXDDDDDEEEEE 


2END AMEND 

2. In this next example, insertion is being performed: 
Enter: AMEND FILEA 
As for replacement, the following is displayed: 


PK1 PK2 *PK3 PK6 
NEXT MODIFY SELECT END 


Press PKI to display the next record: 
1 AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 
Enter the amendment followed by OCK2: 


BBBBB:XXXXX: (OCK2) 

1 AAAAABBBBBXXXXXCCCCC DDDDDAAAAABBBBBCCCCCDDDDD 
Press PK1. 

AAAAABBBBBCCCCCDDDDD AAAAABBBBB CCCCCDDDDDEEEEE 

‘XXXXX:11 (OCK2) 

2 AAAAABBBBBXXXXXCCCCC DDDDDAAAAABBBBBCCCCCDDDDD 
Press PK1 

3 AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 

BBBBB:XXXXX:2 (OCK2) 

3 AAAAABBBBBXXXXXCCCCC DDDDDAAAAABBBBBCCCCCDDDDD 
Press PK1 


4 AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 


BBBBB:XXXXX:26 (OCK2) 
4 AAAAABBBBBCCCCCDDDDD AAAAABBBBBXXXXXCCCCCDDDDD 


Press PK1 
5 AAAAABBBBBCCCCCDDDDD AAAAABBBBBCCCCCDDDDDEEEEE 


>XXXXX:31 (OCK2) 
5 AAAAABBBBBCCCCCDDDDD AAAAABBBBBXXXXXCCCCCDDDDD 


Press PK1 
AAAAABBBBBCCCCCDDDDD AAAAABBBBB CCCCCDDDDDEEEEE 


BBBBB:XXXXX:26 ( OCK2) 
6 AAAAABBBBBCCCCCDDDDD AAAAABBBBBXXXXXCCCCCDDDDD 


27END AMEND 
Output Messages 


Refer to the CREATE utility later in this section for output messages. 
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CH (Change File Name) 
(a function of SYS-SUPERUTL) 


This utility allows the operator to change the name of a file or group of files on disk. The <DATA> 
option allows the data file of an indexed pair to be changed, and it will also cause the keyfile to refer 
to the new data file name (the keyfile name does not change). 


Format: 
< group-name > < DATA> < group-name > 
at aa _e L = 
< file-name > < file-name > : 
The message ‘‘END CH”? is displayed when CH has finished. 
Examples: 


To change the name of single file: 


CH BPS320D/DCSTSK36K TO DCSTSK 
CH DCSTSK TO INDISK3TSK 


To change a group of files: 


CH BPS320A/AR= TO BP= 
CH PRB= TO PR= 


To change several different files: 

CH DCSTSK TO INDISK3TSK, BPS320A/AR TO BP 
To change the name of the data file of an indexed pair: 

CH AR200K <DATA> TO AR200BU 
Note: if a change of group file name is specified with the <DATA> option, then the data file should 
appear in the directory after the keyfile. If this is not the case, then the name of the data file is 
changed first, and when the attempt to change the keyfile name is made, a ‘‘data file-name NOT 


FOUND”’ message will be displayed. This will not occur when changing the name of a single indexed 
file. 


Output Messages 


Message Possible Causes Suggested Action 
<filename> NOT The specified file is not Look for the reason in the 
CHANGED changed. The reason is given second message displayed. 

in the second message 

displayed. 
FAMILY <familyname> The specified files are not Look for the reason in the 
NOT CHANGED changed. The reason is given second message displayed. 


in the next message displayed. 


4-22 


Message 


—INVALID FILE NAME 
WOULD BE GENERATED 


~THE FILE IS ALREADY 
ON DISK 


—KEY FILE <filename> 
NOW POINTS TO DATA 
FILE <filename> 

CH WILL NOT RUN — 
SUPERUTILITY FUNCTION 
ALREADY RUNNING 


<filename> CHANGED TO 
< filename > 


2032801 


(continued) 
Possible Causes 
The file-id to be generated is 
either SYSMEM or spaces or 
longer than 12 characters. 


Attempt has been made to 
duplicate the name of a file 
on disk. 


Successful completion of data 
file name change. 


Another function of SYS- 


SUPERUTL is being executed. 


Successful completion of 
filename change. 


Suggested Action 
Re-input with other file name. 


Re-input with other output 
filename. 


None. 


Wait until SYS-SUPERUTL is 
free, then re-input. 


None. 
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CHECKADUMP (Compare Library Tape with Disk) 


This utility allows the operator to compare information in files on a library tape with corresponding 
files on disk. It is used to verify that a library tape is correct after files have been DUMPed, or that 
disk files are correct after files have been ADDed or LOADed. Specified tape is processed sequentially, 
file by file, and the disk is searched for corresponding files. The utility will notify the operator on 
up to four errors in a given file. If there are more than four errors, it will ignore the rest of that 
file, and proceed to the next file on tape. 


The maximum size of the initiating message is 600 bytes in length. 


If CHECKADUMP has been ZIPped by the LD utility and the comparison produces no conflicts, then 
the ‘Updated bit’ is reset. See ARCHIVING USING UPDATE FACILITY for an explanation of ‘Up- 
date bit’. 


Syntax: 


— CHECKADUMP ———__——._ << library-tape-name > WITH <disk-name > 


< file-name > 


< group-name > 


<library-tape-name> This is the name of the library tape. 


<disk-name > This is the name of the disk on which the files to be compared reside. 
< file-name > These are the files to be compared. 

< group-name > 

<both> If the option ‘‘<both>”’ follows a keyfile, then the corresponding data 


file will also be compared. 
Examples 
To compare files on the tape called PRTAPE with the corresponding files on the system disk: 
CHECKADUMP PRTAPE 
To compare files on the tape called ARTAPE with the corresponding files on a disk called ARDISK2: 
CHECKADUMP ARTAPE WITH ARDISK2 


To compare the file TESTFL on the tape called BRTAPE with the corresponding file on the disk called 
ARDISK3: 


CHECKADUMP BRTAPE WITH ARDISK3/TESTFL 


To compare the keyfile KEYO1 and the data pertaining to it, both keyfile and data file are on the 
system disk, and the tape name is TAPE: 


CHECKADUMP TAPE KEY0!1 <BOTH> 
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Output Messages 


Message 


—<tape name> IS NOT A 
RECOGNIZED LOAD/ 
DUMP TAPE 


<file name> NOT 
CHECKED 


FAMILY <family name> 
NOT CHECKED 


—DIRECTORY ON TAPE 
<tape name> IS CORRUPT 


COMPARISON ERROR 
DETECTED WHILE 
CHECKING <file name> 


—DISK FILE HEADERS DO 
NOT MATCH 


—FILE SIZE MISMATCH 
—FILE TYPE MISMATCH 


—RECORD SIZE 
MISMATCH 


—BLOCK SIZE MISMATCH 


~ GENERATION NUMBER 
MISMATCH 


NO DISCREPANCIES 
BETWEEN DUMP TAPE 
<tape name> AND DISK 
<disk name> 


DISCREPANCIES FOUND 
BETWEEN DUMP TAPE 
<tape name> AND DISK 
<disk name> 
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Possible Causes 


First record of tape not 
recognized by 
CHECKADUMP. Tape may 
not have been created by LD 
utility. 

CHECKADUMP has not 
checked the file. The reason 
is given in the second message 
displayed. 


CHECKADUMP has not 
checked the family name. The 
reason is given in the second 
message displayed. 


More or fewer entries in 
directory on tape than 
specified in the first record of 
tape. 


Comparison error found while 
checking filename. Reason is 
given in the second message 
displayed. 


Header in body of tape is not 
identical to respective header 
in disk directory. 


Difference in sizes of disk 
and tape files. 

Difference in file types of 
files being compared. 
Difference in record sizes of 
files being compared. 
Difference in block sizes of 
files being compared. 

The file has been modified 
since the creation of the tape. 
CHECKADUMP found no 


discrepancies while checking 
contents of the tape. 


Discrepancies found while 
checking the contents of the 
tape. 


Suggested Action 


None. 


Look for the reason in the 
second message given. 


Look for the reason in the 
second message given. 


None. 


Look for the reason in the 
second message given. 


Recreate dump tape. 


Recreate dump tape. 
Recreate dump tape. 
Recreate dump tape. 
Recreate dump tape. 
As file has been changed, new 


back up is necessary. 
None. 


Recreate dump tape. 
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(continued) 

Message Possible Causes Suggested Action 
~HARDWARE ERROR The utility has found an Check integrity of specified disk. 
DETECTED WHILE irrecoverable read error while 
READING DISK <disk reading. the specified disk. 
name > 
-FILE WAS NOT The specified file has not Recreate dump tape. 
SUCCESSFULLY DUMPED been dumped successfully. 

-—TAPE SHOULD HAVE The information on the tape Recreate dump tape after 
BEEN PURGED is such that CHECKADUMP purging the tape. 
cannot handle it. 
—NO FILES TO CHECK There are no files on the tape Check input and re-enter if 
which can be checked with necessary. 


the files on the specified disk. 


Note: Refer to ‘Common Utility Output Messages’’ for additional messages. 
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CHECK.DISK (Check all Sectors of a Disk) 


This utility checks either a specified area, or the whole area, of the specified disk by checking blocks 
of 32 sectors. If an error occurs in a block, each sector within that block is checked individually. 


Format: 


“«_” oH < end-address > 


< start-address > 


CHECK.DISK < disk-id > <start-address > | <( number of sectors > 


It is possible that, because of a hardware failure, an error may be detected when a block read is being 
performed but no errors are detected during the subsequent sector-by-sector read of that block. This 
is referred to as an ‘‘inconsistent error’’. 


When inconsistent errors are encountered, CHECK.DISK continues execution. It is therefore possible 
to have several read error messages output by the MCP while the utility displays a ‘NO HARDWARE 
ERRORS DETECTED” message on completion of the check. 


Checking of only defined areas is permitted by specifying sector ranges in the initiating message (start 
and end addresses or number of sectors). 


These sector ranges may be up to eight decimal numbers or up io six-digit hex numbers delimited by 
the characters @ (AT) or . (PERIOD). 


Example: 


CHECK.DISK ARBK 32-128 
or CHECK.DISK ARBL @000020@-@000080@ 


The disk-name must be specified if sector ranges are required. If sector ranges are not specified, the 
utility will default to checking the complete disk from sector zero to the end address. 


The following fetch values are returned by CHECK.DISK for abnormal termination: 


Fetch Value Description of Cause 
2 Illegal parameters found. 
32 A non-fatal parameter found; for example, sector range exceeding maximum 


disk address. 
Output Messages 


Message Possible Causes Suggested Action 
— <disk-name> IS NOT A An attempt was made to Check input for correct disk 
PHYSICAL DISK run CHECK.DISK on a name. 

pseudo-disk. 

HARDWARE ERROR The utility has found an Look for the reason in the 
DETECTED WHILE error. The impact of the second message given. 
CHECKING SECTOR error will be given in the 
<number> ON DISK second sentence displayed. 
<disk-id > 
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Message 


—SECTOR IS DELETED 
AND SHOULD NOT 
CAUSE SYSTEM 
PROBLEMS 


—SECTOR IS RELOCATED 
AND SHOULD NOT 
CAUSE SYSTEM 
PROBLEMS 


—SECTOR IS AVAILABLE 


—HARDWARE ERROR 
DETECTED WHILE 
READING LABEL ON DISK 
< disk-name > 


-~SECTOR IS ALLOCATED 
TO FILE <file-name> 


—SECTOR IS ALLOCATED 
TO THE DIRECTORY 
AVAILABLE TABLE 


~SECTOR IS ALLOCATED 
TO THE FILE DIRECTORY 
NAME LIST 


- ALLOCATION OF 
SECTOR IS UNKNOWN 


— ALLOCATION OF 
SECTOR CANNOT BE 
DETERMINED DUE TO 
ERROR ON DIRECTORY 


~SECTOR IS ALLOCATED 
TO A TEMPORARY FILE 


—SECTOR IS ALLOCATED 
TO A TEMPORARY FILE 
ON PSEUDO-PACK <disk- 
name> 
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(continued) 
Possible Causes 


Self-explanatory. 


Self-explanatory. 


The sector containing the 
error is referenced in the 
available table and does not 
cause a system problem at 
this time. However once the 
available area is occupied it 
will cause a problem. 


The utility has found an 
error in the label of the 
specified disk. 


The sector in error is a part 
of the specified file. 


The sector in error is a part 
of the available table. 


The sector in error is a part 
of the name list. 


Due to other problems on 
the disk the utility cannot 
find where the sector in 
error is allocated. 


Due to other problems on 
the disk the utility cannot 
find where the sector in 
error is allocated. 


The sector in error is a part 
of a temporary file. Any 
program using this file will 
detect an error and may go 
DS or DP. 


The sector in error is a part 
of a temporary file. Any 
program using this file will 
detect an error and may go 
DS or DP. 


Suggested Action 


None. 


None. 


Use ‘“*XD’’to delete the sector, or 
save the information and re- 
initialize the disk. 


Use Stand-alone utiltiy ‘‘IN’’ or 
DSKUTL IN to re-initialize the 
disk. 


Use COPY with the RECOVER 
option to save the error free part 
of the file. 


To prevent problems the disk 
should be initialized. 


To prevent problems the disk 
should be initialized. 


To prevent problems the disk 
should b be initialized. 


To prevent problems the disk 
should be initialized. 


Make the sector available and run 
aa, © D Laem 


Make the sector available and run 
“xXD’’, 


Message 


HARDWARE ERROR 
DETECTED Ax” 
SECTOR <nur 
WHILE CHEC: 


<disk-name > 


-—EXACT LOCs.7 20°. 
CANNOT BE [Desk le8 


—SECTOR IS IN TRACK 
ZERO 


~FILE <file-name> IS NO 
LONGER ACCESSIBLE 


NO SECTORS CHECKED 
ON DISK <disk-name> 


DISK <disk-name> 
CHECKED 


DISK <disk-name> 
SECTOR RANGE <sector 
range> CHECKED 


DISK <disk-name>. 
SECTOR <number> 
CHECKED 


— <number> HARDWARE 
ERROR(S) WERE 
DETECTED WHICH 
COULD CAUSE SYSTEM 
PROBLEMS. 


—HARDWARE ERROR(S) 
WERE DETECTED BUT 
SHOULD NOT CAUSE 
SYSTEM PROBLEMS 


—NO HARDWARE 
ERROR(S) DETECTED 


—TOO MANY HARDWARE 
ERRORS DETECTED, 
PLEASE POWER OFF DISK 
< disk-name > 
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(continued) 
Possible Causes 


The utility detected an error 
but cannot find out the 
exact address. The reason is 
given in a second message. 


Due to other problems on 
the disk the utility cannot 
find the exact location of 
the sector in error. 


The utility has detected an 
error in track zero of the 
specified disk. 


The specified file can no 
longer be accessed since the 
file header is unreadable. 


The utility was not able to 
check the specified sectors 
on the specified disk. The 
reason will be given in the 
second sentence displayed. 


Normal output. 


Normal output. 


Normal output. 


Self-explanatory. 


Self-explanatory. 


Your disk is in a perfect 
condition. 


The disk is in a very bad 
condition. If re-initialize 
does not solve the problem, 
you may need technical 
assistance. 


Se Te 


Suggested Action 


Look for the reason in the next 
message displayed. 


To prevent problems, the disk 
should be initialized. 


Initialize the disk. 


Back up the rest of the files and 
re-initialize. 


Look for the reason in the 


second message given. 


None. 


None. 


None. 


Back up the files and re-initialize 
the disk if the number is more 
than zero. 


None. 


None. 


Re-initialize the disk then re-run 
CHECK.DISK 
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Message 


SECTOR RANGE FROM 
<number> IGNORED, 
BEYOND END OF DISK 
<disk> 


END OF DISK <disk- 
name> REACHED DURING 
RANGE FROM SECTOR 
<number > 


—SECTOR IS ALLOCATED 
TO THE PSEUDO DISK 
TABLE 


—SECTOR IS ALLOCATED 
TO THE FILE DIRECTORY 
HEADER AREA 


CHECK.DISK ON <disk- 
name> COMPLETED — 
NO ERRORS 

CHECK.DISK ON <disk- 
name> SECTOR <address> 
— NO ERRORS 


CHECK.DISK ON <disk- 
name> AREA <address> 
— <address> COMPLETED 


SECTOR <start-address > 
BEYOND END OF DISK 
<disk-name> 


(continued) 
Possible Causes 


The sector range after the 
specified number is too high 
for the spec:fied disk. 


While checking a part of 
the specified disk the end of 
the disk was reached before 
the end of the specified 
range. 


The sector in error is part 
of the PPIT. 


The sector in error is a part 
of the file directory header 
area. 


Normal EOJ messages. 


Only one sector specified for 
checking and found to be 
readable. 


An area of sectors checked. 


The utility will continue 
with the next sector range 
specified. 


Suggested Action 
Check input. 


None. 


Back up the files and re-initialize 
the physical disk. 


Back up the files and re-initialize 


the disk. 


None. 


None. 


None. 


None. 


Note: refer to ‘‘Common Utility Output Messages’’ for additional aid. 


COMPARE (Compare Files) 


This utility compares corresponding records in two files, or in pairs of files within two groups. A re- 
alignment feature is also available as an aid to detecting missing records. 


Format: 


yoo] S lei > 
COMPARE —-L— NopRINT ——LL- <diskia>/ tL <group-id> —t-— WITH ——— 


< file-id > 


< disk-id > / < group-id > R 


The NOPRINT option results in suppression of the full printed error listing. Instead, the following 
is displayed on the SPO only when the first error occurs. 


FIRST DIFFERENCE FOUND BETWEEN FILES 


RECORD <record-number>, BYTE <offset> OF <file-namel > 
RECORD <record-number>, BYTE <offset> OF <file-name2> 


The following warning messages can be displayed before comparison of records of two files begins. 


rT <filenamel> AND <filename2> ARE DIFFERENT 


1. WARNING — FILE 
if the file types of the two files are different. 


2. WARNING — RECORD SIZE OF <filenamel> AND <filename2> ARE DIFFERENT 
—~ ONLY <X> RECORDS WILL BE COMPARED 


if the default or specified record sizes of the records, when X is the smaller of the two record 
sizes, will be compared. 


3. WARNING — SPECIFIED KEY SIZES FOR <filenamel > AND <filename2> ARE DIF- 


FERENT 
— ONLY <X> BYTES WILL BE COMPARED 


If the specified comparison key length of one file differs from the default or specified record 
size or specified comparison key length of the other, only the first X bytes from the specified 
or default offsets will be compared. The utility continues in each case. 


Examples 
To compare file PQ60R on the system disk with file PQ60RS on disk PRB3: 
COMPARE PQ60R WITH PRB3/PQ60RS 
To compare the groups of files beginning with AR and the files A27Q on disk ARBK1 and ARBK2: 


COMPARE ARBKI/AR= WITH ARBK2/AR=, 
ARBK1/A27Q WITH ARBK2/A27Q 


To compare the file IV20F on the system disk with the file of the same name on disk 132, with realign- 
ment: 
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COMPARE IV20F WITH 1I32/IV20F R 


Format Of Printer Output 


If corresponding records are different, the following is printed: 


NOTE 
The hex-byte of @00@ is printed as ‘‘00’’. 


“‘<file-namel >’’ denotes the first specified file name; 
“< file-name2>’’ denotes the second specified file name; 
“‘comparison key’’ denotes the specified part of a record or the complete record by default. 


When using the NOPRINT option, SPO messages remain unchanged. 
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4, 


5 


DIFFERENCE(S) FOUND FROM BYTES @‘n’@ and @‘m’@ where n is an offset in the 
record of <file-namel>, and m is an offset in the record of <file-name2> (in hexadecimal) 
of the first pair of differing bytes. 


Either: 


RECORD. ‘n’ OF FILE <file-namel > COMPLETE RECORD - (if whole record in <file- 
namel> is being compared) 


or 


RECORD. ‘n’ OF FILE <file-name2> COMPARISON KEY - (if only part of a record 
in <file-namel> is being compared) 


@‘n’@ ‘hex-string’ ‘“‘ ‘ASCII character string’ ”’ 


where n is the offset within the record (in hexadecimal), hex-string is the first 32 byte section 
of the comparison key in hexadecimal, and character-string is the same bytes in ASCII. This 
line is repeated until the whole record or comparison key has been printed. The last line is 
truncated if it represents less than 32 bytes. 


NOTE 
Only the bytes actually being compared are printed. 


RECORD ‘n’ OF FILE <file-name2> DIFFERENCE(S) — 
Line(s) representing section(s) of the comparison key of records in the same format as 3. 


If a comparison key has been specified for one or both files, and the offset differs for each 
file, then a map of the comparison key from the record in <file-name2> is printed; the 
record offsets at the beginning of each line section differ from those in 3, but each line corre- 
sponds to the line in the same ordinal position in 3. 


If the offset for the comparison key in each file is the same (this includes the whole of each 
record being compared), then only line(s) representing sections of the comparison key which 
contain one or more differing bytes will be printed; the record offsets at the beginning of each 
line correspond to the line with the same record offset in 3. If one or more sections have 
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no differing bytes, then ‘“‘NO DIFFERENCES IN SECTION(S) NOT PRINTED” is printed 
at the end of 5. : 


In lines which are printed, only bytes which differ from 3 are actually printed; ‘‘..’’ (hex) 
and ‘‘.’? (ASCII) is printed in place of the bytes which do match. This means that all differing 
bytes can be spotted by the user. 


Comparison of groups of files works as in the following example: 
Assume DISK1 contains the files A, B, C, D, AB, AC, ABC, BC. 
Assume DISK2 contains the files A, B, C, D, AB, AC, ABC, BC, BD, EF. 


Then 
COMPARE DISK1/= WITH DISK2/= compares all files on DISK1 with the corresponding files 
on DISK2. 


But 
COMPARE DISK2/= WITH DISK1/= compares files on DISK2 with the corresponding files on 
DISK1, and will fail to find DISK1/BD and DISK1/EF. 


Similarly, 
COMPARE DISK1/A= WITH DISK2/A= compares files A, AB, AC and ABC on DISK1 with 


the corresponding files A, B, AC and ABC on DISK! with the corresponding files on DISK2. 


Also 
COMPARE DISK1/A= WITH DISK2/AB= compares the following pairs of files: 
DISKI/A with DISK2/AB, 
DISK1/AB with DISK2/ABB, (not found) 
DISK1/AC with DISK2/ABC, 
DISK1/ABC with DISK2/ABBC (not found) 


R Option 
The realignment option works in the following manner: 


If three consecutive records fail to compare then an attempt is made to compare the third record of 
the second file with the next two records of the first file. 


If all these five comparisons fail then an attempt is made to compare the fifth record of the first file 
with the fourth, fifth, sixth and seventh records from the second file. 


If this comparison fails, then the comparison is terminated with an appropriate message (see later). 


If a correct comparison occurs at any stage, then the compared records are used as synchronization 
for restarting normal comparisons. 


For example, consider FILE] containing 10 records A, B, C, D, E, F, G, H, I and J, and FILE2 
containing twelve records K, L, M, N, O, P, Q, R, S, T, U and V. 


The utility compares record A with record K, then B with L, then C with M. If all these comparisons 
fail, then if realignment is specified record M is compared with records D and E. If this also fails, 
record E is compared with records N, O, P and Q. If none of these compare, the comparison is termi- 
nated. 
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Note that if there is a missing record in one file, and realignment is NOT specified, a comparison error 
will arise on every succeeding record until end-of-job. 


Additional Capabilities 


Further features in this utility are summarized in the railroad chart given in figure 4-2, which gives 
the complete input specifications. 


For B 900 systems, the utility attempts to open SYSMEM on all PPIT listed units for directory scan- 
ning and searches for a PPIT entry with a tag of @20@ for the system pseudo disk-name. 


NOPRINT < file-name-sp > —— WITH — < file-name-sp > R 


>— COMPARE < family-name > —— WITH —— < family-name > 


where < file-name sp > is 


< device sp > < attributes > <key sp > <record sp > 
>»>—_—- < file-name > esa Oa Ae sch 


where < device sp > is 
DSK 
MTP EBCDIC 
CRD 
PTR 


< attributes > is 


< block factor > 
> < record-size > a ee 


<key sp > is 
<no. of bytes > ——___—_> 


>-—- KEY 
< no. of records > 
< start record no. > coor Een el eee 


< byte offset > ‘hyphen’ 


< record sp > is 


>———— RECORDS 


Figure 4-2. Railroad Chart for COMPARE Utility 


4-34 


Oo 
Non-Disk Devices 


Files on devices other than disk may be compared by following the file name by one of the following 
keywords: 


CRD — any 80-column or 96-column card device 

PTR — any paper tape input device 

MTP any magnetic tape or cassette device 

DSK any disk device (the default; this keyword is for documentation only) 


Examples 


To compare records on a cassette file ARDUMP/FILE020 with a file AR578QQ on disk WDSK: 


COMPARE ARDUMP/FILE020 MTP WITH WDSK/AR578QQ 


(note that the two-part name is valid for multi-file tapes or cassettes, refer to section 2 for naming — 
conventions). 


To compare two card files DAT1 and DAT2: 
COMPARE DAT1 CRD WITH DAT2 CRD 
Record and Block Sizes 


The record size (and the number of records per block) may be specified after the file name and device 
keyword if applicable. 


Examples: 


To compare a system disk file CU265 with a magnetic tape file TPF, treating data blocks on the tape 
as 80-byte records blocked 9 records to a block: 


COMPARE CU265 DSK WITH TPF MTP 80 9 


To compare a system disk file SCRO1 containing 90-byte records with a system disk file SCRO2 contain- 
ing 180-byte records, but reblocking the second file as 90-byte records: 


COMPARE SCROi WITH SCRO02 90 2 


Note that if the records to be compared are of different lengths, and reblocking is not specified, then 
only the number of characters in the shorter record are compared. 


If EBCDIC is used, the file will be translated from EBCDIC on input. 


The option KEY allows the comparison to be done only on the field defined, the remainder of each 
record will be ignored. The first number is the offset of the field within the record, the second is its 
length. If two files have keys of different lengths, the shorter length will be assumed for both the files. 
A hyphen must be specified between the offset and length: 
NOTE 
The EBCDIC option is only applicable with non-disk devices. 
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Examples: 
Compare fields starting at byte 11 for 4 characters of FILE1 with FILE2 


COMPARE FILE1 KEY 10-4 WITH FILE2 10-4 


The option RECORDS allows the comparison to be done only on the records specified. The first num- 
ber is the starting record number and the second number is the total number of records available for 
comparison. No other record will be read from that file. 


Example: 
Compare records 12, 13, 14 of FILE1 with records 10, 11, 12 of FILE2. 


COMPARE FILE1 RECORDS 12 3 WITH FILE2 RECORDS 10 3 


Limitations 


The maximum record size is 1024 bytes. If a file exceeds this record size, it may be compared by reb- 
locking. For example, a file with record size of 1200 can be compared by reblocking as 600 bytes 
blocked 2, or as 300 bytes blocked 4. The higher the blocking factor, the slower the comparison will 


be. (if the record size is a prime number P, it can be reblocked as 1-byte records blocked P.) 


The use of a star-file terminates the list of pairs of files to be compared. For example, 


COMPARE A= WITH DK2/A=, X= WITH DK2/X=, 
STFILE, B= WITH DK2/B= 


will compare A=, X=, and all files mentioned in the file STFILE, but will ignore the comparisons 


of B= 


Output Messages 


Message 


<file name> NOT 
COMPARED 


FAMILY <family name> 
NOT COMPARED 


—FAMILY MAY BE 
INCOMPLETE 


—HARDWARE ERROR 
DETECTED WHILE 
READING PSEUDO-PACK 
TABLE ON DISK <disk- 
name> 
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Possible Causes 


The utility could not compare 
the specified file. The reason 
is given in the second 
message. 


The utility could not compare 
the specified files. The reason 


is given in the second message 


displayed. 


The utility is requested to 
compare a family of files on 
a pseudo disk but at least 
one physical disk is not 
ready. 


The utility detected an error 
in the PPIT of the specified 
disk. 


Suggested Action 


Look for the reason in the next 
message displayed. 


Look for the reason in the next 
message displayed. 


Ready the drive using ‘“‘RY”’ 
command and re-enter. 


Check integrity of the specified 
disk. 


Message 


—FAMILY <family name> 
MAY BE INCOMPLETE 


FIRST DIFFERENCE 
FOUND BETWEEN FILES 


—SPECIFIED KEY <key 
spec> IS INVALID OR 
BEYOND END OF RECORD 


—SPECIFIED RECORD 
RANGE IS INVALID 


—RECORD SIZE IS 
GREATER THAN THE 
UTILITY LIMIT OF 
<record size> 


HARDWARE ERROR 
DETECTED WHILE 
READING RECORD 
<number> OF <file-name> 


UNABLE TO CONTINUE 
COMPARING <file-name> 
AND <file-name>, 
CANNOT REALIGN FILES 


END OF FILE REACHED 
ON <file-name> BEFORE 
< file-name > 


<filename> COMPARED 
WITH <filename>, 
<number> RECORD(S) 
ARE DIFFERENT 


—SPECIFIED RECORD 
<number> IS BEYOND 
END OF FILE 


FILE TYPES OF <file 
name> AND <file name> 
ARE DIFFERENT 
RECORD SIZE OF <file 
name> AND <file name> 
ARE DIFFERENT 


SPECIFIED KEY LENGTHS 
FOR <file name> AND 
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(continued) 
Possible Causes 


The utility is requested to 
compare a family of files on 
a pseudo disk but at least 
one physical disk is not 
ready. 


The utility has found 
differences. The next message 
displayed indicates where these 
differences occur. 

The key specification in the 
input message is not suitable 
for this file. 


The numbers following the 
keyword RECORDS in the 
initiating message are invalid. 


The utility is not able to 
handle record sizes greater 
than 1024. 


The utility has encountered a 
read error on the specified 
record. 


The utility is not able to 
realign the specified files. 


The file specified first is 
smaller than the second file. 


Self-explanatory. 


The record number specified 
in the initiating message is 
not in the file. 

The specified files are not of 
the same types. 


The specified files do not 
have the same record size. 


Self-explanatory. 


Suggested Action 


Ready the drive by using ‘“‘RY”’ 
command and re-enter. 


Look for the reason in the next 
message displayed by utility. 


Check input and re-enter. 


Check input and re-enter. 


None. Utility limitation. 


Check integrity of the specified 
file. 


None. 


None 


None. 


Check input. 


None. 


None. 


None. 
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(continued) 


Message Possible Causes Suggested Action 
<file name> ARE 
DIFFERENT 
—ONLY <number> BYTES  Self-explanatory. None. 
WILL BE COMPARED 
~SPECIFIED RECORD OR The utility is not able to None. Utility limitation. 
BLOCK SIZE IS INVALID handle the specified record or 
block size. 
RECORD SIZES OF <file- The files to be compared None. 
name AND <file-name> have different record sizes. 
ARE DIFFERENT Only a part of the record will 
be compared. 
—ONLY ‘‘n’? BYTES WILL _ Self-explanatory. None. 


BE COMPARED 
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COPY (File Copy) 
This utility allows the operator to copy files from one medium to another. 


See figure 4-3 for syntax. 


If, as a result of copying a file, a duplicate filename would be created, the original file on the destina- 
tion disk is removed automatically. 


If the option ‘‘& COMPARE” is specified, the utility will compare the newly created output file with 
the specified input before closing the output file. 


If errors are detected it will output: 


COMPARISON ERROR DETECTED WHILE CHECKING <output file> 
<input file> NOT COPIED 


If the file being copied is a keyfile and the <KEY> option is used, the keyfile is copied and the new 
keyfile refers to the original data file. 


If the file being copied is a keyfile and the <BOTH> option is used, the keyfile and the corresponding 
data file are copied. The data file is given the keyfile name with the letters, “QQ” appended. The 
new keyfile is made to refer to the new data file name. 


If the file being copied is a keyfile and neither <KEY> nor <BOTH> options are used, only the 
corresponding data file is copied. The records of the new data file are copied in keyfile order. 


Examples: 

To copy a file called AR200 from the system disk to a disk called ARBU: 
COPY AR200 TO ARBU/AR200 

To copy files called AR200 and AR300 from the system disk to a disk called ARBU: 
COPY AR200 TO ARBU/AR200, AR300 TO ARBU/AR300 

To copy a file called APTASK from the system disk to APBU, changing its name to APTASKB: 
COPY APTASK TO APBU/APTASKB 

To copy all files beginning with letters ““PR’’? from disk PR2 to disk called PRBU: 
COPY PR2/PR= TO PRBU/PR= 

Copying Keyfiles 

Assume there is a keyfile called PR200K which refers to a data file called PR200. 

The statement 


COPY PR200K <KEY> TO PRB/PR200K will create a new keyfile PR200K on disk called PRB 
which references the original data file, PR200, on the system disk. 


2032801 aA6 


* < file-name > 


> 


& COMPARE < group-copy > 


— COPY 


<s-file > TO <d-file> 


< group-copy > is defined as : 
<KEY> SHARED 


FREE 


> < group-name-1 > 


———— 


aac jak =] F AT HOSTNAME <host-id > al a Rae! 


<s-file > is defined as : 


PACK 
CRD 
1 MTP 
<BOTH> 
| recover 
1 


< KEY > 
SHARED 
1 
FREE 
< disk-id > / AT HOSTNAME <host-id > 
i ame | < file-id > 
1 RECORD — <nr> 
1 BLOCK ——<nb> 
1 TAPE.MARKS —< nt > 
1 NO.LABEL 
< r-spec > 1 EBCDIC 


Figure 4-3. Railroad Chart for Copy Utility (Sheet 1 of 2) 
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<d-file > is defined as : 


| 71 \— RECORD — <nr>— | 


1 BLOCK —— <nb> 
1 FILESIZE — <nf> 
| 1 SINGLEAREA | 


CRUNCH 
EXTENDING 
EBCDIC 
NO.LABEL 
AT HOSTNAME <host-id > 


e disk-id 77 
< file-id > 


<r-spec > is defined as : 


< number > 


<r-count > 
<record-key > 
< record-key > 


Figure 4-3. Railroad Chart for Copy Utility (Sheet 2 of 2) 
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The statement 


COPY PR200K <BOTH> TO PRB/PR200K will create a new keyfile and data file on disk called 
PRB. The name of the new data file will be PRB/PR200KQQ and the keyfile (PRB/PR200K) will 
refer to this new data file. 


The statement 
COPY PR200K TO PRB/PR200K will create a new datafile PR200K on the disk PRB. No new 
keyfile will be created but the records in the new data file will be created in key order according 
to the keyfile. 


Additional Capabilities 
Further features in this utility are summarized in the railroad chart given in figure 4-3, which gives 


the complete input specifications. 


NOTE 
The facility to copy from or to an EBCDIC file is not supported for disk 
files. 


Non-disk Devices 


Files may be copied to and from media other than disks. Abbreviations for the valid devices are as 
follows: 


MTP — magnetic tape or cassette 
CRD — punched card 
PTP — paper tape 
Examples: 
To copy a cardfile called PRFILE to a disk called PRBU: 


COPY PRFILE CRD TO PRBU/PRFILE 
To copy a disk file called PR300 to a single-file magnetic tape: 


COPY PR300 TO PRTAPE MTP 


NOTE 
This tape is in ‘“COPY”’ tape format, not ‘“LOAD/DUMP”’ format. To ac- 
cess this tape file again it will have to be placed on an appropriate device 
by the “COPY” utility, not ‘‘LOAD/DUMP’”’. 


To copy a cardfile called PRFILE to paper tape: 


COPY PRFILE CRD TO PTFILE PTP 
NOTE 
Paper tapes are always ‘‘unlabelled’’, and when accessing it, MCP will issue 
an appropriate message requiring an ‘‘AD”’’ intrinsic response from operator. 
See ‘‘AD”’ intrinsic. 
Unlabelled Tapes 
Input tapes with no CMS labels (‘‘unlabelled’’ tapes) may be accessed by the COPY utility. 


In addition, unlabelled output files may be created which use the Disk File Header attributes of the 
input disk file. 
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The NO.LABEL option allows the copying of unlabelled files. On recognizing an unlabelled file, the 
MCP will print ‘‘<mix-number>/COPY <28> WAITING SPURIOUS/ <tape-name> AT DEVICE 
ASSIGNMENT REQUIRED”’. The operator must then respond with an appropriate ‘‘AD’’ input mes- 
sage (see “‘AD’’) to identify the unlabelled file. 


The end of file recognition for unlabelled files is determined by tapemark count. The TAPE.MARKS 
option allows the operator to specify the total number of tapemarks which will indicate end of file 
to the utility when copying an unlabelled file. The default value is 2. Each tape mark which is encoun- 
tered will contribute to this total. Therefore, a standard labelled CMS file will be copied up to, but 
excluding, the trailing label if NO.LABEL is specified by itself. (The standard CMS labelled tape for- 
mat is ‘“‘label; tape mark, data, tape mark, label’’, see CMS MCP Reference manual.) The operator 
must be aware of the format of any file which is to be copied when using the NO.LABEL option. 


If the RECORD size is not 180 bytes, refer to the section on Record/Block modification. 
Example: 


To create a disk file called EMPL from first file of a magnetic tape with non-standard label (the format 
being: LABEL, TAPEMARK, DATA, TAPEMARK): 


COPY TP MTP NO.LABEL TAPE.MARKS 2 TO EMPL 
NOTE 


contain a copy of the non-standard label. An unlabelled tape may be created 

by specifying NO.LABEL with MTP as the output file attribute. 
Record and Block Sizes 
Record and/or block sizes may be modified for all file types, input and output. 
The number of bytes in the record or block is specified using the corresponding ‘‘numbers’’. The 
record and block sizes of input files are always taken from the file itself (Disk File Header). Record 
and block sizes of non-disk input files are determined as follows: 


Record size: 


If RECORD is specified, ‘‘number’’? becomes the new record size. 
If RECORD is not specified record size defaults (see below). 


Block size: 


If BLOCK is specified, ‘‘number’’ becomes the new block size. 
If no BLOCK specified, but RECORD is specified, record size becomes new BLOCK size. 


If neither BLOCK nor RECORD is specified, Block Size defaults (see below). 
Default Values: 

Output disk = same as input disk. 

Input labelled tape/cassette = from tape label. 

Input unlabelled tape/cassette = 180 bytes. 

Cards = 80 or 96 bytes, depending on device. 
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If the record size is increased, then the additional bytes will be filled with spaces if the input file is 
a source or data file, or with binary zeros for any other type of file. 


Example 


To copy an 80-column card file labelled PROGSRC to a disk file called PROGSRC on a user disk 
““USR’’, and make the record size and block size of the disk file 80 bytes and 720 bytes respectively: 


COPY PROGSRC CRD TO USR/PROGSRC RECORD 80 BLOCK 720 


To copy a disk file PRBU/PR300 to magnetic tape with large blocks suitable for tape media: 


COPY PRBU/PR300 TO PRTAPE MTP RECORD 180 BLOCK 1800 
File Size 


The “‘FILESIZE attribute’ of a disk file may be specified for the output disk file. Note that only 
assigned areas are copied. This feature does not increase disk space at the time of copying, but allows 
programs to add further records if required. At that time disk space may be needed. The maximum 
filesize you may declare depends on the type of disk unit the fiie has to be on, the record and block 
size of the file and whether or not the single area option is on for the file. 


Example 1: 


A file with a record size of 180 and a blocksize of 80 to be copied as as a multi-area file to a B 9493- 
80 (allocation unit is 8) will have a maximum filesize of 1048448 records. When the same file is to 
be copied to a B 9493-10 (allocation unit is 1) then the maximum filesize is 1048560 records. A file 
with a record size of 80 and a blocksize of 720 to be copied as a multi-area file to a B 9493-80 will 
have a maximum filesize of 1048320 records. 


Example 2: 

To copy FILE1 and increase its ‘‘“FILESIZE” to 1500, replacing the original by the copy: 
COPY FILE] TO FILE! FILESIZE 1500 

Single Area 


The “‘SINGLEAREA”’ attribute may be specified for the output disk file. This ensures that the new 
file will occupy a single disk area. 


Example: 
COPY FILE2 TO FILE2 SINGLEAREA 
Crunching Files 


The ‘CRUNCH attribute’? may be specified for the output file. This causes any unused disk space 
at the end of the file to be returned to the system. 


Example: 


COPY PRB/PR200 TO PRB78/PR200 CRUNCH 
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WARNING 
A file cannot be ‘‘uncrunched’’ once it is crunched. This means it cannot be 
extended. It can only be used for inquiry. This option is therefore useful for 
storing history files. 


Extending Disk Files 


Records eunye added to the end of an 


i 
hn 
aa 
ae 
2: 
2] 
A 
5 
“S. 
5 
z= 
| a 
= 
oO 
Oo 


Example: 


A data file called DFTUES was created with Tuesday’s data. To add this data to the end of a file 
called DFMON (containing Monday’s data): 


COPY DFTUES TO DFMON EXTENDING 
(Note the size of DFMON must be large enough to contain all required records). 
EBCDIC 


The EBCDIC option may be specified for either the input or output file. When an ASCII input file 
has to be copied to an EBCDIC output file, use the following syntax: 


COPY <filel> TO <file2> EBCDIC 

When an EBCDIC input file has to be copied to an EBCDIC output file enter: 
COPY <filel> EBCDIC TO <file2> EBCDIC 

Free And Shared 


Files which are in use for output (but not locked) by another program or are ‘‘shared’’ may only be 
copied by specifying ‘‘FREE’’ or ‘SHARED’ as appropriate. 


Recover 
If a file contains records which are unreadable due to bad disk areas, that file may be copied only 
by specifying RECOVER as an input file parameter. Only source, data, EBCDIC data and binary data 
files may be recovered. 
Unreadable records in the input file will be replaced by ASCII ‘X’ character filled records in the output 
file, unless the file is EBCDIC, in which case an EBCDIC ‘X’ will be used. Copy will report the record 
number of each substituted record. 
Selected File Copy 
Selected record numbers from the input file may be copied. 
Example: 
To copy 500 records starting at record #1200 from file FILE] to file FILE2: 

COPY FILE! 1200 500 TO FILE2 
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NOTE 
Pairs of numbers may be specified within each pair; the first number specifies 
a relative record number and the second specifies number of records to be 
copied. If an extra number is specified, the last number specifies copying 
from that record to the end of the file. 


Example: 

To copy records 100 to 149, 300 to 499, and 1000 to end of file: 
COPY FILE1 100 50 300 200 100 TO FILE2 

Selected Index File Copy 


For indexed files, copying of records can be selected based on content of the key. There are two op- 
tions: the number of records or an ending key value can be specified. 


Examples: 


PQR is a keyfile containing personnel records. To copy 15 records from the corresponding data file 
starting from the record with personnel number 01786 io a data file, P : 


COPY PQR 01786 15 TO PSNL 


Using the same keyfile, to copy all data records from personnel number 01786 to 01800 to data file, 
PSNL: 
COPY PQR 01786 — 01800 TO PSNL 


NOTE 
The second option is specified by the hyphen in the COPY statement. Note 
that at least one space is required before and after all key values (personnel 
number in this case). 


The above keys can optionally be expressed in hexadecimal format at follows: 


COPY PQR @06FA@ 15 TO PSNL 
or COPY PQR @06FA@ — @0708@ 


Save Factor 

New magnetic tapes are given a save factor of 999. 

Copying Files To And From Remote CMS And Non-CMS Systems 
This facility may be used on a B 900 system which is a host in a BNA network. 


Disk files may be copied to and from remote host systems by specifying: ‘‘AT HOSTNAME <host- 
id>’’ after the appropriate file or family name. 


NOTE: 
1. A family of files can be copied to but not from a remote host non-CMS system. 
2. If files have to be copied to or from a disk pack on a remote host non-CMS system, ‘‘PACK”’ 
must be specified following the host-id of that system. 
3. Index files cannot be copied from one host system to another. 
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Output Messages 


Message 


<file-name> COPIED TO 
< file-name> 


<filename> REMOVED 


— <filename> CONTAINS 
NO RECORDS 


<filename> NOT COPIED 


FAMLIY <family name> 
NOT COPIED 


FRIVAT IT WIIG 
“LUNVALIY PilE 


SPECIFICATI 
< file-name > 


—FILE IS CURRENTLY 
BEING USED BY 
ANOTHER PROGRAM 


—REQUESTED FILES 
WERE NOT FOUND 


FOR 


—RECORD SIZE EXCEEDS 
MAXIMUM SET FOR THIS 
RUN, PLEASE RESUBMIT 


— FILE NAME GREATER 
THAN 12 CHARACTERS 
WOULD BE GENERATED 


COMPARISON ERROR 
DETECTED WHILE 
CHECKING <file-name> 


—DISK <disk-id> IS NOT 
A CMS DISK 
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Possible Causes 
COPY successful. 


COPY successful. If a 
duplicate file is encountered 
by COPY, it is automatically 
removed. 


COPY successfui, but no 
records are actually written to 
the new file. 


The specified file is not 
copied. The reason is given in 
the next error message 
displayed. 


The specified family is not 
copied. The reason is given in 
the next message displayed. 


The enarifieatinn ar 
BLY OPerrsiwativily, Ui 


combination of specifications. 
given is not permitted. 


The specified file is in use by 
another program. 


The specified files are not 
found in the directory of the 
specified disk. 


Copy has encountered a file 
with a record size greater 
than expected. 


Copy of a group of files was 
requested. At least one 
filename that was to be 
generated would have been 
more than 12 characters long, 
maximum length of file-names 
is 12 characters. 


File not copied because of an 
error found when comparing 

the output file with the input 
file. 


A family has been specified 
for copying from a NON- 
CMS system. Families cannot 
be copied. 


Suggested Action 
None. 


None. 


Check for correct file-name. 


Look for the reason in the 
second error message displayed. 


Look for the reason in the 
second error message displayed. 


Check innut for 


NeHIUN KK Lkpruie ad 


specifications. 


earrect 
COrrcce 


Use ‘““SHARED”’ or ‘‘FREE”’ 
option to copy the file. 


Check input for correct disk and 
file-names. 


Check input for correct record 
size. 


Check input for correct family 
name. 


None. 


Do selective copies of every file 
mentioned in the input file 
specification. 


4-47 


Message 


—NO RECORDS IN 
KEYFILE <file-name> 


—KEYFILE OR DATAFILE 
IS CURRENTLY BEING 
USED BY ANOTHER 
PROGRAM 


—KEYFILE OR DATAFILE 
NOT FOUND 


—KEYFILE OR DATAFILE 
IS ON A DISK WHICH IS 
CURRENTLY LOCKED BY 
ANOTHER PROGRAM 


— ASSOCIATED DATAFILE 
<filename> NOT FOUND 


—HARDWARE ERROR 
DETECTED WHILE 
READING KEY <key> 


~HARDWARE ERROR 
DETECTED WHILE 
READING RECORD 
<record number > 


—HARDWARE ERROR 
DETECTED WHILE 
WRITING RECORD <record 
number > 


— OUTPUT FILE TOO 
SMALL 


— <file-name> NOT 
FOUND 


—OUTPUT FILE <file- 
name> NOT COMPATIBLE 


—KEYFILE OR DATAFILE 
IS ON A DISK WHICH IS 
CURRENTLY LOCKED BY 
ANOTHER PROGRAM 


— FILE IS NOT AN 
EBCDIC FILE 
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(continued) 
Possible Causes 


<BOTH> option was used. 
Utility was not able to access 
a data file because of some 

failure in the keyfile. 


Another program has opened 
the file for output use. 


Specified file is not in the 
directory of the specified disk. 


Specified keyfile or datafile is 
on a disk whose SYSMEM is 
opened with lock-access by 
another program. 


The datafile which belongs to 
the specified keyfile is not in 
on line. 


Error encountered when 
reading specified key. 


Error encountered when 
reading specified record. 


Error encontered when writing 
specified record. 


Filesize of output file is too 
small to contain all the 
records of the input file. 


A file has been specified for 
extending but has not been 
found. 


A file has been specified for 
extending and is not of the 
same type or record size as 
the input file. 


Self-explanatory. 


A disk file has been specified 
for translation from EBCDIC 
which is not an EBCDIC data 
type file. 


Suggested Action 


Check input for correct syntax 
or use SORT to create a new 
keyfile. 


Use ‘‘FREE”’ or ‘“SSHARED’’ 
option in initiating message if 
other program does not use the 
file with LOCK-ACCESS. 

Check input for correct disk and 
file-names. 

Wait until the other program is 
finished and re-enter. 


Bring associated datafile on line 
and re-enter. 


Check datafile for errors or use 
“RECOVER” for copying the 
readable records. 


Check datafile for errors or use 
‘““RECOVER”’ for copying the 
readable records. 


Check output medium. 


Re-enter the COPY with suitable 
FILESIZE option. 


Check input and re-enter. Check 
for correct medium. 


Check that input and output file 
are the same type and have the 
same record size. 


None. 


None. 


Message 


FAMILY MAY BE 
INCOMPLETE 


FAMILY FOR COPYING 
MAY BE INCOMPLETE 


<file-name> CANNOT BE 
COMPARED USING THE 
SPECIFIED OPTIONS 


END OF FILE REACHED 
ON <file-name> DURING 
RANGE FROM RECORD 

<record number > 


END OF FILE REACHED 
ON <file-name> DURING 


RANGE FROM <key> 


<file-name> RANGE FROM 
RECORD <record-number > 

IGNORED SINCE OUT OF 

SEQUENCE 


<filename> RANGE FROM 
RECORD <record-number > 
IGNORED SINCE END OF 
FILE REACHED 


SUBSTITUTE RECORD 
<record-number> IN FILE 
<file-name> WILL 
CONTAIN X CHARACTERS 


—RECORD SIZE LIMIT IS 
10000 


—INDEXED FILE ACCESS 
NOT PERMITTED ON A 
REMOTE HOST 


—FILE OF THIS TYPE 
CANNOT BE COPIED 
BETWEEN HOST SYSTEMS 
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(continued) 
Possible Causes 


A family is specified for 
copying from an unrestricted 
pseudo-disk and at least one 
of the physical disks is not 
available. 


A family is specified for 
copying from an unrestricted 
pseudo-disk and at least one 
of the physical disks is not 
available. 


The specified file is not a 
diskfile, or is an indexed file, 
or inappropriate options have 
also been specified. 


End-of-file encountered while 
section of file indicated by 
record-number number is 
being copied. 


End-of-file encountered while 
section of file indicated by 
key is being copied. 


A non-disk file or null-key 

keyfile is being copied with 

record selection, the selected 
ranges must be in sequential 
order. 


Once the end of null-key 
keyfile or a non-disk file is 
reached, no further selections 
can be copied. 


The RECOVER option has 
been used and an unreadable 
record has been found at 
<record-number>, a 
substitute ‘‘X’’-filled record 
has been written to the 
output file. 


The utility cannot handle 
record sizes greater than 
10000. 


It is not permitted to copy 
indexed files with the AT 
HOSTNAME option. 


It is not permitted to copy 
non data files with the AT 
HOSTNAME option. 


Suggested Action 
None. 


None. 


None. 


None. 


None. 


None. 


None. 


Check output file for ‘‘X’’-filled 


records and replace them with 
the original contents using the 
the FILEUTL utility. 


None. Utility limit. 


None. 


None. 
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(continued) 
Message Possible Causes Suggested Action 
ILLEGAL. PARAMETER A file-name greater than 
LIST <file-name> seven characters has been 
entered and COPY to TAPE 
has been requested. 


Re-enter the file-name using not 
more than seven characters. 
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CP (Compute) 


This utility allows simple computations to be made, with the answer displayed in decimal and 
hexadecimal. Input may be either decimal or hexadecimal. Hex values must be enclosed in @ symbols. 


The utility may be initiated with a single computation to perform, in which case it will do the calcula- 
tion and terminate. If no calculation is initially provided, the utility issues an ACCEPT to enable the 
computation to be entered. In this case the utility will do the calculation and then issue further AC- 


CEPTS until a null input to the ACCEPT is given. 


Format: 


CP J < integer > 


< integer > 


The numbers accepted are any decimal or hex values in the range 
0 999999999999999[ @38D7EA4C67FFF @] 
or the negative equivalent. 
Parentheses are not allowed. The calculation is performed on a strictly left-to-right basis. The operators 
+, —, *, /, and M are for addition, subtraction, multiplication, division and modulus division (the 
result is the remainder) respectively. 
Examples: 
To compute the hexadecimal value of the decimal number 12345: 
CP 12345 
To compute the value of the complex expression: 


CP 555 * 3 + 2-100 * 2/5 


(Note: the result of the above is 626, because the calculation is done strictly left-to-right). 


Output Messages 


Message Possible Causes Suggested Action 
— <number> IS NOT A Two consecutive operators None. 
VALID NUMBER (for example +) have been 
entered with no number 
between. 
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Message 
— <number> IS NOT A 
VALID HEXADECIMAL 
NUMBER 


— <operator> IS NOT A 
VALID OPERATOR 


OVERFLOW DETECTED 
BY CP DURING 
CALCULATION 


DIVISION BY ZERO 
DETECTED BY CP 


~ NUMBER EXCEEDED 
99999 99999 99999 (@ 
03807EA4C67FFF@) 


CP: RESULT — <result> 
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(continued) 
Possible Causes 


Illegal symbol; missing an @ 
symbol at front or back of a 
hexadecimal value. 


Illegal symbol; or an operator 
(for example, +) has been 
omitted. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


Normal output. 


Suggested Action 
Re-input. 


Re-input. 


None. 


None. 


None. 


None. 


CREATE (Create Disk File — B90 Only) 


This utility allows the operator to create or extend data or source disk files. The ‘‘AMEND”’ and ‘‘UP- 
DATE”’ utilities use many similar features. 


t= < filename > 
| f—— TABSTOP —— — < number > ————<—=| | 


CREATE ee ae < f-spec > 
RECORD 
S BLOCK ————_ < nb> 
fb A FILESIZE <n/> 
< file-name > N CRUNCH 


— < disk-id > ~] 


When creating a new disk file, certain attributes may be specified. 


<f-spec > is defined as : 


If the S option is selected, a source file will be created using alphanumeric input. If the A option is 
used, a data file will be created using alphanumeric input. The N option creates a data file with 
hexadecimal (numeric) input. If none of these is selected, S is assumed. Alphanumeric input is accepted 
as typed, but numeric (hexadecimal) input requires two characters (0-9, A-F) for each byte of the 
record. 


The RECORD option allows the operator to specify the number of characters per record of the new 
file. If no record size is specified, a record size of 80 bytes is assumed for source files, and 180 bytes 
for data files. 


The BLOCK option allows the number of characters per block of a new file to be defined. The defaults 
are as follows: 


If RECORD size was specified but no BLOCK, BLOCK size will equal RECORD size. 


If neither RECORD nor BLOCK is specified, RECORD size will be 80 bytes for source files and 180 
bytes for data files; BLOCK size will be 160 bytes for source files, 180 bytes for data files. 


The FILESIZE option allows the maximum number of records likely to be written to the new file. 
This is useful in allocating only as much disk space as required by the file. Once the FILESIZE has 
been specified for a file, that file can never be extended beyond that number of records. However, 
the COPY utility may be used for increasing the FILESIZE of an existing file. The default is 2048 
records. 


The CRUNCH option allows the operator to specify that the new file should occupy the minimum 
area of disk, but never be extended. 
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The numbers specified for the ‘‘numbers’’ option may be used to set “‘tab”’ positions within the record 
(similar to setting “‘tabs’’ on a typewriter). If tabs are set, the operator may input data, press OCK1, 
and the utility will reposition the print mechanism to the next tab position within the record, and await 
data input. During this repositioning, CREATE will fill all character positions left unspecified in the 
record with a ‘‘filler’? (ASCII space for source input, ASCII zero for alphanumeric input, and binary 
zero for numeric zero). The record length plus one will be used as a termination tab position, whether 
or not other tab positions are specified. 


CREATE can be used for record sizes up to 500 bytes, but since the utility cannot be given input great- 
er than the width of the console, tab positions are mandatory on files of larger record sizes. For exam- 
ple, a file of 180 byte records requiring alphanumeric input will require at least one tab position (for 
instance, at position 100). A file of 180 byte records requiring hexadecimal input will require a 
minimum of three tab positions (for instance at positions 50, 100 and 150). The maximum tab size 
is 111 in alphanumeric input and 54 in hexadecimal input. That is, the difference between two 
consecutive tab positions should be less than or equal to 111 in alphanumeric input and less than or 
equal to 54 in hexadecimal input. 


By specification of TABSTOP in the initiating message, CREATE sets up tab positions coinciding with 
the end of the console line as well as any other tabs specified. Also, when in Record Input Mode 
(PK1), CREATE accepts information only up to the next tab position. 


Default tab positions have been chosen to allow a maximum number of characters to be inserted on 
one line. CREATE uses nine for the record number and 110 for the contents of the record. In addition, 
manually-selected tabs may still be used. 

Default tab positions for the end of the console lines for CREATE are as follows: 


Source or data alphanumeric : 111 221 331 441 
Data hexadecimal : 56 111 166 221 276 331 386 441 496 


Examples: 
Tabs Set at: 
CREATE FILEA RECORD 410 TABSTOP 111 221 331 
CREATE FILEB A RECORD 500 TABSTOP 51 61 51 61 Lil 221 331 441 
221 
CREATE FILEC N RECORD 450 TABSTOP 56 111 166 221 276 331 386 441 496 


The EXTENDING option is used to add records to an existing file. The attributes, such as RECORD 
and BLOCK sizes, are taken from the old file. The file type is also taken from the existing file. The 
operator may specify ‘‘A’’ for alphanumeric input or ‘‘N’’ for hexadecimal input. If neither ‘‘A’’ nor 
““N’’ is specified, ‘‘A’’ is assumed. If a file is CREATE EXTENDed, the generation number of the 
file is incremented by one. 


Examples: 


To create a source file called ‘“‘ICFILE”’, record size 100 bytes with 5 records per block, tab position 
set at 65: 


CREATE ICFILE RECORD 100 BLOCK 500 65 
To create a source file called “ICFILE’’ with record size 80, block 3, and a maximum of 20 records 


in the file: 
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CREATE ICFILE RECORD 80 BLOCK 240 FILESIZE 20 


To extend a source file called ‘“‘ICFILE’”’ (note: the utility will automatically prompt the operator for 
the next sequential record number to be created): 


CREATE EXTENDING ICFILE 


is set at 50, 100 and 150. 


ate a data file called ‘““CFILE”’ for hexadecimal input with tab position 


CREATE CFILE N 50 100 150 


The utility operates in two modes: “RECORD INPUT””’ (entered through PK1) and ‘‘RECORD MOD- 
IFY’’ (entered through PK2). 


PK1 PK2 PK3 PK4 PKS PK6 
input modify - - - EOJ 


An OCK3 option is included, to display the current tab position. 


An OCK4 “help” option is provided, which will output the above options when pressed. In order to 
show which mode the utility was in when OCK4 was pressed, an asterisk (*) is printed next to that 
mode on the Help display. 


The ‘“‘Record Input Mode’’ (PK1) is used to enter new records through the keyboard. Characters are 
input followed by OCK1 for each tab position. 


The ‘“‘Record Modify Mode’’ (PK2) is used to make corrections to the last record input. The point 
in the record at which alterations are to be made is selected by typing an identifying group of charac- 
ters immediately preceding the byte(s) of the record to be altered. The portion of the record to be re- 
placed or inserted follows the identifying characters, delimited by a colon (:). If alterations are to be 
made at the beginning of the record, no identifying characters are necessary. A starting byte position 
for the identifying character string search may be specified in the console input (see AMEND for de- 
tails). 


If OCK1 is used to terminate input, the characters to be altered will replace the corresponding number 
of characters in the record. 


For example, for a record containing ‘‘ABCDEF’’, the amendment C:XY:OCK1 will result in ‘‘ABC- 
XYF’’. 


If OCK2 is used to terminate input, the characters delimited by colons (:) will be inserted at the indi- 
cated point. The insertion can cause characters in the record to be moved to the right. The shifting 
of characters applies only to those characters from the starting byte to the next higher relevant tab 
position; characters beyond this tab position will not be affected. 


For example, a record specified with tab positions at 4 and 8, contains ““ABCDEFGHIJ’’. The amend- 
ment C:WXY: OCK2 will result in ““ABCWXYDHIJ’’. 


Initially the utility will be in the ‘‘Record Input Mode’’, and on completion of an entry in any mode, 
it will allow the operator to select the mode not in use, or terminate the utility (with PK6). Unless 
otherwise instructed, it will continue in the existing mode. 
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Output Messages 


Message 


— FILE DIRECTORY ON 
DISK <disk-name> IS 
FULL 


UNABLE TO ACCESS 
< file-name > 


— SPECIFIED RECORD OR 
BLOCK SIZE IS INVALID 


OUTPUT FILE TOO 
SMALL 


RECORD SELECTION 
ERROR 


ILLEGAL RECORD 
NUMBER SPECIFIED 


RECORD REQUESTED IS 
BEYOND EOF 


EOF REACHED DURING 
DELETIONS 


FILE TYPE IS NOT DATA 


E.O.F REACHED 


ILLEGAL PARAMETER 
LIST — BAD ATTRIBUTE 


— NO OR INVALID TAB 
POSITIONS SPECIFIED 
FOR RECORD SIZE 

< number > 


NOT HEXADECIMAL 
CHARACTER INPUT 
RESUBMIT 
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Possible Cause 
Self-explanatory. 


The specified file name is not 
on disk or is in use by 
another program. 


Self-explanatory. 


Attempt was made to add 
records to specified file 
beyond its maximum file-size. 
File is closed with lock. 


Attempt was made to select a 
non-existent record. 


Attempt was made to select 
record greater than the 
number of records in file, or 
zero. 


Attempt was made to select 
record beyond end of file. 


Attempt was made to delete a 
record beyond end of file. 


Input type A or N has been 
specified and the type of file 
given for extension is not 
data. 


The last logical record of the 
output file has been entered 
(applies to the utility 


Specified record and block 
sizes are incompatible or 
blocking factor > 255. 


Tab positions beyond end of 
record were specified; or 
input fields larger than 
capabilities of console. 


Character other than 0-9 and 
A-F was input. 


Suggested Action 
Re-run create on another disk. 


Check input for correct file- 
name. 


Check input for correct record 
and block size. 


List the file to check which 
records have been entered: then 
use CREATE EXTENDING to 
add the desired records. 
Alternatively use UPDATE with 
the FILESIZE option. 


Check input and re-enter if 
necessary. 


Check input and re-enter if 
necessary. 


Usually indicates update is 
complete; utility terminates 
normally, no action need be 
taken. 


Usually indicates file update is 
complete; utility terminates 
normally, no action need be 
taken. 


Check the file type and re-input 
correct file type. 


Select PK2 to modify record or 
PK6 to go to end-of-job. 


Check input and re-enter. 


Check input and re-enter. 


Check input and re-enter. 


a 


Message 


ODD NUMBER OF 
HEXADECIMAL 
CHARACTERS INPUT 


INPUT ERROR — 
RESUBMIT RECORD 
MODIFICATION 


BYTE WITHIN RECORD 
SPECIFIED NOT FOUND 


UNWANTED KEY 
PRESSED — PLEASE RE- 
INPUT 


INPUT IMMEDIATELY 
BEFORE PK6 HAS BEEN 
LOST 


(continued) 
Possible Cause 


Warning message that an odd 


number of hexadecimal 
characters was input. When 


input mode is ‘‘hexadecimal’’, 


utility expects even numbers 
of input characters. 

Input error during ‘‘record 
modify mode’’. 


The identifying string of 
characters for record 
modification could not be 


found in the record specified. 


Invalid OCK was pressed. 


Characters were input 
immediately before PK6 was 
pressed to terminate the 
utilitv. These characters will 


Meveaee Ge = AH 


not be written to the specified 


file. 


Suggested Action 


None. Utility accepts the input, 
but adds a zero onto the end 
(right) of the input to even it 
out. 


Check input and re-enter record 
modification. 


Check input and terminate the 
entry with the correct OCK. 


Re-enter input and terminate the 
entry with the correct OCK. 


Restart the utility using modify 
mode to correct this record if 
desired. 


Note: Refer to ‘““Common Utility Output Messages’’ for additional messages. 
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DA (Disk Analysis) 


This utility allows the operator to read any portion of a CMS-format disk. It is an interactive program, 
with the operator entering a range of commands via the console (if the PRINTER option is not 
specified), or the SPO by means of an accept (AX) command if PRINTER is specified. Output is di- 
rected to a line printer when the PRINTER option is invoked. 


The utility is commonly used to print the contents of the disk directory. In general, if the PD utility 
operates correctly for a specific disk, then DA should also run successfully. Specifically, the disk car- 
tridge label, the name list entry and disk file header for SYSMEM must be intact. (Refer to the CMS 
MCP manual for details of the disk format and directory structures.) 


Analysis of Standard CMS Disks 


Format: 


er NO.LABEL = al 
——_ -, = ——— 


| | | | r—— PRINTER —— 
DA poe Le ee Saree Lane / <file-id > 


The utility operates in two modes ‘‘disk mode’’ and “‘file mode’’. If no file name is specified, the 
utility operates in ‘‘disk mode’’. If no disk-name is specified, the system disk is analyzed. 


Disk Mode 


In this mode the operator can enter a number of commands via the keyboard. These commands can 
be abbreviated according to the table provided at the end of this section. The format and meaning 
of each command in disk mode is given below. 


END 


Terminates the utility. 
LABEL 


Reads and formats the contents of the disk cartridge label. 
DFH 


Reads and formats the contents of selected disk file headers. This command is followed by other de- 

tails, given here: 

DFH - ALL 
NEXT 
OF < file-id > 
TEMPORARY 


@< sector-number > @ 


< sector-number > 


The ‘“‘TEMPORARY”’ option displays the headers of all temporary files. 
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The “ALL” option displays the headers of all files, and their contents if in use. 


The “‘OF” option displays the header of the specified file or family of files: all headers will be checked 
and duplicates will be displayed if found. 


The ‘‘sector-number” option displays any sector in disk file header format, where the number is a 
decimal sector address. If preceded by an @ symbol, the sector-number is in hexadecimal. This feature 
can be used after displaying other parts of the directory, which include sector addresses for disk file 
headers in hexadecimai. 


The ‘““NEXT”’ option displays the header of the next file in the directory. 
AVAIL. TABLE 


Reads and formats the contents of selected parts of the disk availabie space table. This command is 
followed by other details, given here: 


AVAIL.TABLE ALL 
AVAIL 
BAD 
INVALID 
< number > 
@< number > @ 


The “‘ALL”’ option displays the entire available table. 
The “AVAIL”? option displays entries for available area only. 
The ‘“‘BAD” option displays entries for bad sectors only. 


The “INVALID” option displays all entries in the available table which are invalid, in that the 
“length”? entry does not equal the difference between “‘start address’? and ‘‘end address’’. 


The ‘‘sector-number’’ option displays any sector in available-table format, where the number is a 
decimal sector address in hexadecimal. 


NAME.LIST 


Reads and formats the directory name list, including the sector addresses of associated disk file head- 
ers. This command may be followed by other details, given here: 


NAME.LIST 


NAMES 
OF <file-id > 
TEMPORARY 
< number > 
@< number > @ 


If no further details are given, then the entire name list is displayed. 
The “‘“NAMES’”’ option displays entries for old (existing) files only. 
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The ““TEMPORARY”’ option displays entries for temporary files only. 


The ‘‘OF”’ option displays the entry for the specified file or group of files: all headers will be checked 
and duplicates will be displayed if found. 


The “‘sector-number’’ option displays any sector in name-list format, where the number is a decimal 
sector address. If preceded by an @ symbol, the sector-number is in hexadecimal. 


Format headings for Name.List available table or Pseudo Pack Identification Table will not be printed 
if no entries have been found relating to the requested option. 


READ 


Reads and displays the contents of any specified sector in hexadecimal and ASCII format. This com- 
mand may be followed by other details, given here: 


ONLY 
READ 
NEXT 


| 
[_ < number > al 
@< number > @ 
The “‘ONLY”’’ option inhibits the display of information. 


The ‘‘NEXT”’ option will read the next sector. Note that after some operations which involve a search, 
the ‘‘next’’ sector may be indeterminate. After a READ of sector n, a READ NEXT will read sector 
n+i. A READ command with no further details is taken as a READ NEXT. 


The ‘‘number’’ option reads the sector whose address is the number. If preceded by an — symbol, 
the sector-number is in hexadecimal. 


DISPLAY 


Displays the current sector address and contents of the program’s sector-buffer. The first DISPLAY 
command must be preceded by a READ command. A READ ONLY followed by a DISPLAY is equiv- 
alent to a normal READ. 


KFPB 


The Key File Parameter Block of a keyfile can be printed. 
KFPB TL. OF < file-id > i 
OF < family-id > 


If the file specified is a key file, then record 1 of that file is selected and the information is printed. 


PPIT 


The Pseudo Pack Identification Table can be found from the Disk Cartridge Label and requested infor- 
mation may be printed: 
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PPIT ALL 
NAMES 


OF < file-id > 
tes << umber > 
The “number” cosucr <issiays the sectors from the PPIT. 


The “NAMES” op-ice <isplays the used entries of the PPIT. 
The “ALL” option displays every sector of the PPIT. 

The “‘OF disk-name”’ option displays the entry for that disk. 
File Mode 


In file mode, the utility can be used to read selected records. Only the information commands are valid: 


The READ command has the same format as in disk mode, except that the ‘‘number’’ refers to the 


jogical record number in the file, and a READ NEXT will read the next logical record in ihe file. 


Analysis of Non-CMS Standard Disks 


DA can analyze a non CMS standard disk (unlabelled disk). This is accomplished in the following way: 
1. The drive of the disk to be analyzed is RDed. 
2. “NO.LABEL’”’ is specified in the initiating message. 
3. The utility then opens an unlabelled disk and the user is prompted to AD a disk drive that 
has previously been RDed. 


The initiating message for analyzing non CMS standard disks is: 


NO.LABEL >—————_TF 


L_ printeR — 


Command options available when analyzing a non CMS standard disk: 


< decimal number > 
r> 


< hexadecimal numbe 
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Command options (cont.) 


——_—————__ DISPLAY ————_ 


< sector address > 
READ 


NEXT 


LABEL 
< sector address > 
NEXT 
< sector address > —_+ 


AVAIL.TABLE —— <sector address > —————_—_| 
PPIT ——————____._ < sector address > ———_ 


END ——__—_—____| 
—___— 


NAME.LIST 


Directory searching options (for example DFH OF <file-name>) are not permitted in the unlabelled 
form of the utility, since it is possible that the disk being analyzed is either a non CMS disk or a 
CMS disk with corrupted label and/or corrupted directories. 


In the unlabelled form of the utility, any sector of the disk may be displayed in the DFH, NAME- 
-LIST, AVAIL.TABLE or PPIT format. 


If a command option contains a <sector address> that does not address any sector of the disk being 
analyzed, the following message is displayed: 


OUTWITH DISK — 


In the unlabelled form of the utility, if a command that is not valid in the unlabelled form is entered, 
the utility displays the message: 


NOT VALID IN UNLABELLED MODE 
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General Notes 
In disk mode the sector number starts from zero; that is, ““READ 0”’ will read the first disk sector. 
In file mode the record number starts from one; that is, “READ 1” will read the first logical record. 


Any I/O error causes the ‘‘fetch value’’ to be displayed, with the current sector address if in disk 
e mode. 


e Waren ae, 
node, or current record number if in file 


Families 


A family of files may be specified in the following command options: 


KFPB , 
DFH and 
NAME.LIST 


A group of disks may be specified in the command option: 


PPiT 


For example, ““KFPB OF K=’’, “DFH OF ABC=”, “NAME.LIST OF A=” and ‘“PPIT OF 
DDDDDD =”’ are now permitted. 


All directory entries for files belonging to the specified family, or for disks belonging to the specified 
group of disks, are printer listed if “PRINTER” has been specified in the initiating message, otherwise 
they are console printed. 


Pseudo Disk Tags 


If the disk being analyzed has a PPIT, DA checks the Pseudo Disk Tags of the directory entries when 
scanning for: 


a particular file or 
a family of files 


in the following command options: 
NAME.LIST , 
DFH and 
KFPB 


Initially, Pseudo Disk Tag checking is set for directory entries of files residing on the physical disk 
specified in the initiating message. The user may alter this, so that files residing on other disks are 
scanned for. This is achieved by the following command option: 


< disk-name > —_____——+| 


where <disk-name> is one of the following: 


DISK 


1. The name of an unrestricted Pseudo disk. 
2. The name of a Pseudo disk restricted to the physical disk being analyzed. 
3. The name of the physical disk being analyzed. 
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When the user has entered the command DISK <disk-name>, one of four messages is displayed, ei- 
ther on the SPO (if ‘‘PRINTER”’ has been specified in the initiating message) or on the console. The 
messages are: 


1. PSEUDO DISK TAG OF <disk-name> IS xy 
The PPIT of the physical disk being analyzed contains the specified <disk-name>. xy is its 
hexadecimal Pseudo Disk Tag. 


2. PSEUDO DISK <disk-name> NOT RESTRICTED TO PHYSICAL DISK <physical-disk- 
id> 
The specified <disk-name> is present in the PPIT, but it is restricted to a physical disk other 
than the one being analyzed. ; 


3. <disk-name> NOT FOUND IN PPIT OF <physical-disk-id > 
The specified <disk-name> is not present in the PPIT of the physical disk being analyzed. 


4. NO PPIT ON DISK <physical-disk-id > 
There is no PPIT on the physical disk being analyzed. 


In each case the utility continues to wait for either the next Accept (if in PRINTER mode) or the next 
console command. 


Abbreviations 
For ease of use, input commands and other keywords may be abbreviated, as in the following table: 


READ R 
ONLY oO 
NEXT N 
DISPLAY D 
END E 

ie 


TEMPORARY T 
AVAIL.TABLE 

AVAIL A 
BAD B 
INVALID I 

NAME.LIST N 
NAMES N 


Output Messages 


Message Possible Causes Suggested Action 


OUTWITH <format> In disk mode the sector which None. 
AREA ADDRESS: has been specified to be read 
<number> LENGTH in DFH, NAME LIST, 
<number > AVAILABLE TABLE or 

PPIT format is outwith 

relevant area. 
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Message 
FILE IS NOT A KEYFILE 


NOT FIXED DISK SYSTEM 


DA TERMINATED 


ILLEGAL PARAMETER 
input 


ILLEGAL PARAMETER 
<character-string > 


SUCCESSFUL READ 
REQUIRED FIRST 


NOT VALID IN FILE 


LRANDE 
iviwyivi 


NONE FOUND or NOT 
FOUND 


READ ERROR ON LABEL 
OF <disk-name> 


LAST OPTION 
UNSUCCESSFUL 


ERROR ON READ- 
RECORD: — 


BEYOND END OF FILE- 
RECORD: — 


INVALID SECTOR- 
ADDRESS: — 


NOT VALID IN DISK 
MODE 
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(continued) 
Possible Causes 


The KFPB option has been 
requested and the file which 
was specified is not a keyfile. 


The PPIT option has been 
requested on a non-fixed disk 
system and no Pseudo pack 
identification table exists. 


The END command is 
successful. 

No valid disk name or file 
name has been specified in 
the initiating message. 


More than one option has 
been specified. 


A DISPLAY command has 
been entered before a 
successful read. 


A command other than 
READ or DISPLAY has been 
used in file mode. 


No information has been 
found in answer to a 
command. 


An error was encountered 
while reading sector zero of 
the specified disk. 


The DISPLAY option has 
been requested before a sector 
or record has been read or 
after an option has been 
unsuccessful. 


The disk parity error has 
been encountered while 
reading a record in file mode. 


A record beyond end of file 
has been requested to be read 
while in file mode. 


A sector address beyond the 
last physical sector of a disk 
has been specified to be read 
while in disk mode. 


A command option, that is 
not valid in disk-mode, has 
been entered when the utility 
is running in disk mode. 


Suggested Action 
None. 


None. 


None. 


Re-enter. 


Re-enter. 


Enter a READ command, then 


a DISPLAY will work. 


Check input. 


None. 


None. 


Perform a READ before using 
display option. 


None. 


None. 


None. 


Check input and re-enter. 
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Message 
SYSTEM DISK LOCKED 


DISK <physical-disk-id> IS 
LOCKED 


NOT VALID IN 
UNLABELLED MODE 
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(continued) 
Possible Causes 


The initiating message 
specified that the system disk, 
or a file residing on the 
system disk, is to be 
analysed, but the system disk 
is locked. The utility 


terminates after displaying this 


message. 


The initiating message 
specified that the physical 
disk named <physical-disk- 


id>, or a file residing on the 


physical disk named 
<physical-disk-id>, is to be 
analyzed, but the specified 
physical disk is locked. The 
utility terminates after 
displaying this message. 


Utility is in unlabelled mode 
and a command was given 
which is not valid for this 
mode. 


Suggested Action 


None. Check that no other 
program is using the requested 
disk. 


None. Check that no other 
program is using the requested 
disk. 


Check input and re-enter. 


DSKUTL 


NOTE 
On B 1000 systems, only RF and LIST are implemented. 


The DSKUTL utility provides the following functions: 


IN Initializes a disk. 

RF Reformats a previously initialized disk according to parameters specified in the 
initiating message. 

LIST This function provides the facility to list any range of disk sectors (absolute 
addressing) which are accessible to the system software. 

COPY The COPY function provides the facility to duplicate disks of the same type. Note 


that only BSMII disks are supported by this function. The entire disk contents are 
duplicated including the CMS-reserved areas of the disk. Non-CMS format disks can 
also be duplicated. 
BOOT Replaces the bootstrap code in track zero of a CMS initialized disk without 
changing any other information the disk contains. , 
NOTE . 

This utility has the facility to handle pseudo-disks. This feature is oniy impic- 

mented on B 900 systems. In addition, DSKUTL can only be used by systems 

which implement the ‘‘Open Disk Unlabelled’’ function in the MCP. 


These make the following Stand Alone Utility (SAU) functions available under MCP control: 


IN, FE 

RF (for any SDI disk type and pre-initialized Caelus disks) 
PDX (for any initialized disk) 

DISCOPY (for BSMII disks) 


The disk types which are supported by the DSKUTL RF, IN, BOOT and LIST functions are detailed 
in table 4-2. 
NOTE 


On SDI type disks (BSMII and 211), an execution of the IN function is 
equivalent to the Reformat Function, RF, with the IGNORE option specified. 


In addition to the disk types described in table 4-2, DSKUTL will also support other types of disk, 
including the fixed and floppy disks for the B 95/CP 9350. These disks are not referred to in table 
4-2. The utility will calculate the allocation unit of the disk from its capacity. The physical attributes 
of B95 fixed and floppy disks are not relevant. 


The Mnemonics and device kinds of B 95 fixed and floppy disks are as follows: 


Mnemonic Device Kind 
Floppy DM C8 
Fixed DF C9 
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Table 4-2, DSKUTL — Supported Disk Types 


| TRACKS/ | SECTS/|] ALLOC.| NO. OF 
DISK/PACK |CONTROLLER|MNEMONIC| DEVICE ae See roRS 
DM el 88 


IMB MINI c 2 32 1 @001600@ 
CARTRIDGE) (100TPI) c DK CB 203 2 32 l @0032C0E 
CARTRIDGE] (200TPI) c DK CB 406 2 32 1 @006580€ 
201-I FIXED (single) c DF CC 406 2 64 1 @00CBO0@ 
201-I FIXED (dual) c DF ** CC 406 4 64 2 @019600@ 
211 FIXED (single) s DF CD 335 4 80 2 @01A2C0@ 
211 FIXED (dual) s DF CD 335 8 80 4 @034580@ 
211 FIXED (quad) s DF CD 335 16 80 8 @068B00E€ 
BSMII MINI (3MB) §s DM CE 142 2 59 1 @0041 20 
BSMII MINI (4.7MB) s DM CE 221 2 59 1 @0065C0@ 
M 205 PACK DPC DP CF 407 5 90 4 @02C360€ 
M 206 PACK DPC DP CF 814 5 90 8 @0586E0@ 
M 207 PACK DPC DF/DP CA 1563 8 90 32 @110D60@ 
M 223 PACK | DPC | DP | CF 203 | 20 60 | 4 | @038380@ | 
M 225 PACK DPC 20 8 @076720@ 


c = caelus, s = SDI (Standard Disk Interface) ** = B 900 only 


B 1000 systems only support cartridges and pack. 


Bootstrap Table For IN (B 90 and B 900 Only) 


The CMS Bootstrap is always selected for 211 or 201-I Fixed Disks. MTR sectors are always reserved 
for the 201-I Fixed Disk whether <MTR> is specified in the initiating message or not. For all other 
types of disks, if <MTR> is not specified, the CMS Bootstrap is selected and sectors are not reserved. 


Table 4-3. DSKUTL IN Bootstrap Table 


DEFAULT FILE-NAME 0000000/CMSBOOT 0000000/S YSINITBOOT 
records 2 — 31 CMS BOOTSTRAP — BDS BOOTSTRAP 

records 32 — 61 MTR/CAELUS BOOTSTRAP | MTR/CAELUS BOOTSTRAP 
records 62 — 91 MTR/BSMII BOOTSTRAP MTR/BSMII BOOTSTRAP 
records 92 121 COLDSTART BOOTSTRAP Not applicable. 


MTR INITIALIZE BOOTSTRAP AREAS BOOTSTRAP AREAS 
SELECTED RESERVED SELECTED RESERVED 


1 MB MINI MTR/ 0A80-0ABF MTR/ 0A80-OABF 
CAELUS 0B00-0B3F CAELUS 0B00-0B3F 
1540-157F 1540-157F 


CARTRIDGE (100TPI) MTR/ 1540-157F MTR/ 1540-157F 
CAELUS 2A80-2ABF CAELUS 2A80-2ABF 
2B00-2B3F 2B00-2B3F 


CARTRIDGE (200TPI) MTR/ 2A80-2ABF MTR/ 2A80-2ABF 
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Table 4-3. DSKUTL IN Bootstrap Table 


: (continued) 
BOOTSTRAP AREAS BOOTSTRAP AREAS 
MTR INITIALIZE SELECTED | RESERVED | SELECTED | RESERVED 


CAELUS 2B00-2B3F 


5540-557F 


2B00-2B3F 
5540-557F 


CAELUS 


_ 201-1 FIXED (S) 0080-017F 0080-017F 
5200-527F 5200-527F 
CA80-CAFF CA80-CAFF 
201-I FIXED (D) Not BDS 0080-017F 
supported. 
5200-527F 
CA80-CAFF 
211 FIXED CMS NONE BDS NONE 
(ALL Types) 
BSMII MINI 3 MB MTR/ 1321-140C MTR/ 1321-140C 
BSMII 4012-40FD BSMII 4012-40FD 
BSMII MINI 4.7 MB MTR/ 1321-140C MTR/ 1321-140C 
BSMII 64B7-65A2 BSMII 64B7-65A2 
M 205/206/207/223 CMS NONE BDS NONE 
M 225 Disk Packs Not supported | NONE 1 BDS NONE | 


Area addresses are in allocation units (hexadecimal). 


NOTE 
On the 211 Fixed Disks there are MTR sectors outwith the virtual addressable 
area of the disk. 


DSKUTL operates under MCP control and provides some of the functions of the Stand Alone Utilities 
(SAU). , 


In order to use this utility, the system must be running under an MCP that supports the OPEN/ 
CLOSE disk unlabelled function and a SYSLANGUAGE file must be present. These functions are pro- 
vided by the B 90 MCP version 3.04 and above. 


Before executing DSKUTL, the operator must reserve the disk drive or unit on which the function is 
being performed by means of the RD intrinsic. When the utility begins execution, it opens an unla- 
belled disk and the operator is requested to assign the required disk drive or unit mnemonic, which 
has been previously reserved, by using the AD command. 


The disk to be reserved for access by DSKUTL must not have any files open, thus the disk currently 
in use as the system disk may not be accessed by this utility. 
NOTE 
In order to use this utility, the disks in use must be in a format recognizable 
by the MCP as follows: 


SDI disks are factory initialized, although not necessarily in CMS format, 
and are supported by this utility whether or not they have been previously 
initialized or formatted on a CMS system. 
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ae se eo 
DSKUTL -— <COLDSTART> Option B90 Only 


To allow initialization or reformatting of mini disks (1 MB mini, BSMII mini and B 95/CP 9350 mini 
disks) for Coldstart purposes on a B90 system, the option <COLDSTART> (including angle 
brackets) may be specified in the initiating message of IN (initialize), RF (reformat) and BOOT (boot- 
strap replacement) functions as an alternative to the <MTR> option. 


NOTE 
This option can only be used on a B 90 system. The bootstrap file used must 
be CMSBOOT version 3.04 or later. 


Format 1: IN (B90 and B 900 Only) 
To initialize a disk using DSKUTL the following steps are required. 


The following format provides the initializing (IN) function: 


Dine ace 
DSKUTL—— IN UNIT.FDA FILES 
BOOTSTRAP < disk-id > / < file-id > 


TEST.PATTERNS 
TEST.PATTERN 


<nnnn > ——— CWNER —— < “ aaaaaaaaaaaaaa ” > ——> 


>— SERIAL 


< ssssss > 


<MTR> 
<COLDSTART > 


@ < hex.pattern > @ 
“<< ASCH pattern >” 


The star-file option is implemented in this utility. 


Parameters may also be entered via Accepts — see subsection DSKUTL Reformat and Initialize Param- 
eters — via Accepts. 


To initialize a disk for MTR purposes, <MTR> should be specified. 


Disk-name This field specifies the name written to the disk-label of the disk being 
reformatted. 
UNIT.FDA By specifying UNIT.FDA instead of <disk-name> in the initiating 


message, DSKUTL initializes a 211 or 201-I fixed disk as a physical unit 
with a PPIT, provided the system is running as a fixed disk system. 

The system PPIT is scanned for the first disk-name listed as a physical 
unit which is not on-line. The disk being initialized is assigned this disk- 
name and associated logical unit-number when the utility writes the disk- 
label. 

If all physical units listed in the system PPIT are found to be on-line, the 
disk is assigned a default disk-name of ‘‘O00Oxy’’ where “*xy’’ is the 
logical unit-number (in decimal characters) of the first available unit slot 
in the system PPIT. 


FILES nnnn 


OWNER 
‘“‘sqaaaaaaaaaaaa”” 


SERIAL ssssss 


BOOTSTRAP file- 
name 


TEST.PATTERN or 
TEST. PATTERNS 
pattern list 


<MTR> 


<COLDSTART> 


Machine spec B 90 
or B 900 


This specifies the maximum number of files to be held on the disk. 
<nnnn> is an integer number in the range 1 to 2804. 


This field is used to specify the owner field in the disk-label. It must 
consist of an alphanumeric entry of 1 to 14 characters delimited by quote 
marks (‘‘). 


The serial number field of the disk-label is specified by this field. It must 
be a six-digit integer number and must include leading zeros. 

The bootstrap file-name, if mentioned, specifies the name of the bootstrap 
file to be copied to the disk being initialized. If the BOOTSTRAP option 
is not entered, the utility searches for the default filename as shown in 
table 4-3. 


This option is only applicable to Caelus type disks. The option allows the 
user to specify up to four test patterns to be written to and read from the 
disk being initialized. The test patterns can be up to 20 characters long if 
ASCII, or 40 characters long if hexadecimal. Hexadecimal test patterns are 
delimited by AT symbols (@) and ASCII test patterns are delimited by 
quotes (‘‘). 

The MTR option in the initiating message causes sectors to be reserved in 
the available table for MTR purposes. The number and location of these 
sectors depends on the system and disk type. This option is equivalent to 
the SAU FE function. 

This option causes the COLDSTART bootstrap to be written into track 
zero. This is used to invoke the COLDSTART utility (see COLDSTART 
utility). This option can only be used for BSMII and 1 MB mini disks on 
a B 90 system. 

This option allows the user to specify the bootstrap type applicable to 
either a B90 or a B 900. If the bootstrap file is not specified in the 
initiating message, the utility will expect CMSBOOT to be on the system 
disk if B 90 is specified, or SYSINTBOOT if B 900 is specified. 


NOTE 


The angled brackets round <MTR> and <COLDSTART> must be in- 
cluded in the initiating message. 


Operation 


To initialize a disk, the user inputs an initiating message of the format shown previously. The utility 
then prompts the user with the following message: 


PLEASE RESERVE (RD) DRIVE, THEN INSERT DISK FOR ‘‘IN”’ AND THEN ASSIGN (AD) 


DRIVE 


followed by the MCP prompt: 


<mix number >/DSKUTL PROGRAM SUSPENSION 
ASSISTANCE REQUIRED FOR DISK FILE INITIALIZE 
USE ‘AD’? TO ASSIGN DEVICE 


2032801 


4-71 


eee 
At this point, the user is required to ready (RY) and reserve (RD) the required drive. 


NOTE 
If the disk to be initialized is virgin, it is necessary to reserve (RD) the drive 
before inserting the disk. 


If Test Patterns have been specified and the disk AD’ed is either a BSMII or 211, the utility will ignore 
them. 


If the disk label is already in CMS format, the utility displays the following prompt: 


DISK IN DRIVE Dxy IS LABELLED <diskname> 
PLEASE ENTER OK IF IN IS TO CONTINUE 


followed by the MCP prompt: 


<mix number>/DSKUTL REQUIRED DATA. USE “AX” 


The disk-name is from the label and the operator is required to AX <mix number> OK for the utility 
to continue. 


All previous information on the disk is ignored. 


NOTE 
. DSKUTL tries to read the LABEL of the AD’ed disk. If the disk is virgin, 
an error is detected and displayed by the MCP. DSKUTL continues and ini- 
tializes the disk. DSKUTL displays the following message “CANNOT READ 
LABEL OF DISK IN DRIVE Dxy, WILL ASSUME DISK IS BEING 
INITIALIZED FOR THE FIRST TIME 


Test Patterns for Caelus Type Disks 


For Caelus type disks only (1 MB mini, cartridge, 201 I fixed), the following initialize routine is in- 
voked. Sector addresses are written to the disk using the INIT.TRACK communicate. The utility ter- 
minates if an error condition is returned from this communicate. When writing of sector addresses has 
been completed, the utility writes/reads test patterns to every sector of the disk. If no test patterns 
are specified by the user, three passes are performed. If one or more patterns are specified, four passes 
are performed. 


The three default test patterns are 180 bytes of Hex 00, 180 bytes of Hex FF and 180 bytes of Hex 
63. 


The sequence of test patterns used is as follows: 


No. of Patterns Pass 1 Pass 2 Pass 3 Pass 4 
Specified 
0 Hex 00 Hex FF Hex 63 ~ 
] Hex 00 Hex FF Hex 63 Pl 
2 Hex FF Hex 63 Pi P2 
3 Hex 63 Pi P2 P3 
4 PI P2 P3 P4 


where Pl, P2, P3 and P4 are specified patterns. 


Any specified patterns are repeated to fill 180 bytes. 
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If a disk is being initialized for ACSYS (SL5) use, a test pattern of ‘“‘@FF@’’ should be specified 
for the iast pass so that i86 bytes of “‘@FF@’’ remain on all available disk sectors on completion 
of the initialize function. 


The sectors are read back to verify that patterns were written correctly. If a read or write error is en- 
countered on a sector, or test pattern verification fails, the sector is marked as bad in the available 
table. The bad sector limit is 32 for a 1 MB mini disk and 50 for a cartridge or 201-I. If this limit 
is exceeded or if any MTR sectors to be reserved or sectors of track 0 are found to be bad, the utility 
terminates. This initialization routine is not performed on the factory-initialized BSM II or 211 disks. 


If <MTR> is specified in the initiating message, depending on the system and disk type, MTR sectors 
may be read/write checked and reserved in the available table when constructed by the utility. 


The appropriate bootstrap code is selected from the specified or default bootstrap file. 


The new available table and directories with single SYSMEM entry and the appropriate bootstrap code 
are written to the disk by the utility. If MTR sectors are to be reserved, they are marked as bad in 
the available table. 


Special test patterns are written to the MTR tracks of the BSMII disk. 


If UNIT.FDA was specified, the utility acknowledges with the following message, giving details of the 
disk-name being assigned to the fixed disk. 


DFy WILL BE INITIALIZED AS DISK IN DRIVE <disk-name> 


A 13 sector PPIT is written to the disk with the assigned disk-id, logical unit number and pseudo pack 
tag entered in the relevant physical unit slot. All other entries are made available. When this unit is 
readied by the user after the utility has successfully terminated, the PPIT is modified to match the 
System PPIT by the MCP AVR routine. 


Finally, the utility writes the label to sector zero. 


When initialization has been completed successfully, the utility displays the following message and ter- 
minates: 


DISK IN DRIVE <drive-id> INITIALISED AS <disk-id> 
— BOOTSTRAP IS <type> VERSION <version-number > 
— NUMBER OF BAD SECTORS = <No of sectors marked bad> 


where — <type> = CMS/WARMSTART if the CMS bootstrap was used, 
or 
MTR if either MTR-CAELUS or MTR-BSMII was used, 
or 
COLDSTART if the COLDSTART bootstrap was used. 
<version number> = The version number contained in the bootstrap code, if one exists, other- 
wise 
the version number of the bootstrap file. 
<disk-id> = The name of the disk that the bootstrap has been copied to. 
Pseudo Pack Identification Table Construction 


Slots which are reserved for physical units are marked unable to be used by filling with Hex. 82. 
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SSsSSS09090a SSS SSS Se SS SS 


Slots which are reserved for Pseudo Packs are marked unused by filling with Hex. 80. 
On a 211 type Fixed Disk, 222 slots are available for Pseudo Packs, Hex. 21 — Hex. FE. 


On a 201-I type Fixed Disk, 211 slots are available for Pseudo Packs, Hex. 21 — Hex. F3, the last 
(20th) slot in each PPIT sector is marked as unable to be used. 


Format 2: RF 


NOTE 
The angle brackets must be included in the initiating message for MTR tracks 
to be reserved. Similarly, the angle brackets must be included around COLD- 
START. 


£ < disk-id > 1. 
DSKUTL ——— RF UNIT.FDA FILES <nnnn>——— OWNER < “aaaaaaaaaaaaaa” > ——> 


>—— SERIAL <ssssss> BOOTSTRAP < disk-id > / < file-id > 


B90 
B900 


IGNORE If the IGNORE option is specified, the utility will ignore any information 
already contained in the CMS reserved areas of the disk. This option must 
always be specified if the disk is not already in CMS format. 

If IGNORE is not specified, the utility will expect the disk-label and 
available table to be in CMS format. When re-writing the available table 
to the disk, the utility will accommodate up to 90 bad entries from the 
original available table. If more than 90 bad entries are encountered on 
reading the available table of the disk, the utility will be terminated. 


NOTE: The IGNORE option can be used to reformat a disk which has a 
corrupted label, directories or available table. However, care musi be 
exercised if using this option to reformat Caelus disks (see table 4-2). 
SDI disks, due to the fact that bad sectors are ‘‘hidden’”’ by relocation, 
should never contain bad entries in the available table other than those 
reserved for MTR purposes. Caelus disks, however, often contain a 
number of unusable sectors ‘‘hidden’’ by means of the entries in the 
available table. Use of the IGNORE option will ignore these entries when 
constructing the new available table. Subsequent access of these previously 
noted bad sectors by the MCP can give rise to I/O errors. 


Disk-name This field specifies the name written to the disk-label of the disk being 
reformatted. 

UNIT.FDA (B 900 By specifying UNIT.FDA instead of <disk-name> in the initiating 

only) message, DSKUTL initializes a 211 or 201-I fixed disk as a physical unit 


with a PPIT, provided the system is running as a fixed disk system. 
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The system PPIT is scanned for the first disk-name listed as a physical 
unit which is not on-line. The disk being initialized is assigned this disk- | 
name and associated logical unit-number when the utility writes the disk- 
label. 

If all physical units listed in the system PPIT are found to be on-line, the 
disk is assigned a default disk-name of ‘‘O0O0Oxy’’ where ‘‘xy’’ is the 
logical unit-number (in decimal characters) of the first available unit slot 
in the system PPIT. 


FILES nnnn This specifies the maximum number of files to be held on the disk. 
<nnnn> is an integer number in the range 1 to 2804. 

OWNER This field is used to specify the owner field in the disk-label. It must 

‘‘aaaaaaaaaaaaaa”’ consist of an alphanumeric entry of 1 to 14 characters delimited by quote 
marks (‘‘). 

SERIAL ssssss The serial number field of the disk-label is specified by this field. It must 


be a six-digit integer number and must include leading zeros. 


BOOTSTRAP file- |The bootstrap file-name, if mentioned, specifies the name of the bootstrap 
name (B 90/B 900 file to be copied to the disk being initialized. If the BOOTSTRAP option 


only) is not entered, the utility searches for the default file-name as shown in 
table 4-3. 
<MTR> The MTR option in the initiating message causes sectors to be reserved in 


the available table for MTR purposes. The number and location of these 
sectors depends on the system and disk type. This option is equivalent to 
the SAU FE function. 


<COLDSTART > This option causes the COLDSTART bootstrap to be written into track 
zero. This is used to invoke the COLDSTART utility (see COLDSTART 
utility). This option can only be used for BSMII and 1 MB mini disks on 
a B 90 system. 


A <machine-spec> may now be specified for the IN (Initialize), RF (Reformat) and BOOT (Bootstrap 
replacement) functions. 


<machine-spec> can be either B 90 or B 900. 


This allows the user to specify the type of Bootstrap to be used for the IN, RF and BOOT functions. 
This makes it possible, for example, to create a disk on a B 90 with a B 900 Bootstrap. 


If no Bootstrap file-name is specified in the initiating message, DSKUTL will use ““CMSBOOT”’ (if 
B 90 was specified) or ““SSYSINITBOOT”’ (if B 900 was specified) on the systems disk. 


No prompt will be issued for <machine-spec> if parameters are entered via ACCEPT/DISPLAYs. 
Operation 


On B 90 or B 900 the utility immediately opens the specified or default bootstrap file and verifies that 
the appropriate checksum is correct. The operator is requested to reserve and assign the required disk 
drive or unit. 


If the label of the disk is already in CMS format, the utility displays the name read from the disk- 
label and requests the operator to confirm that reformatting is required. 
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The operator must enter: 
AX <mix number> OK 


in order for the utility to continue. 


The new or existing available table and directory entries and a single SYSMEM entry are written to 
the output disk and on B 90 or B 900 the bootstrap file is copied to the disk. 


On B 900 only, if UNIT.FDA was entered in the initiating message, a 13-sector PPIT is written to 
the disk with the assigned disk-name, and the logical unit-number and pseudo-pack tag are entered in 
the physical unit slot. All other entries are made available. When the unit is subsequently made ready 
by the operator on termination of the utility, the PPIT will be modified to match the system PPIT 
by the AVR routine in the MCP. 


Finally, the utility writes the disk-label to sector zero (0). 


In order to access the disk which has been reformatted, the user must make the disk ready by use 
of the RY command when the utility has gone to successful EOJ. 


Exampie 


To reformat a BSMII (3/6 MB) disk (‘‘TESTA’’), already in CMS format with the following 
parameters: 


Disk-name — DISKA 
Number of files — 1000 
Owner — USER-FRED 
Serial Number — 123456 
Bootstrap file is default 


Insert disk called ‘‘TESTA’’ in drive DMA. 
System displays ‘DMA TESTA/ 0 FILES OPEN’’ 


Enter ‘““DSKUTL RF DISKA FILES 1000 OWNER ‘‘USER-FRED’’ SERIAL 123456 
system displays: 
PLEASE RESERVE (RD) DRIVE, THEN INSERT DISK FOR RF AND THEN ASSIGN (AD) 
<mix-no>/DSKUTL PROGRAM SUSPENSION <28> 
ASSISTANCE REQUIRED FOR DISK FILE REFORMAT 
USE ‘‘AD’”’ TO ASSIGN DEVICE 


Enter: RD DMA 
system displays: 
DMA RESERVED 0 FILES OPEN 


Enter: AD <mix-number> DMA 

system displays: 
DISK IN DRIVE DMA IS LABELLED TESTA, 
PLEASE ENTER OK IF RF IS TO CONTINUE 
<mix-number>/DSKUTL REQUIRES DATA. USE ‘‘AX”’. 


Enter: AX <mix-number> OK 


system displays: 
DISK IN DRIVE DMA REFORMATTED AS DISKA 
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— BOOTSTRAP IS CMS/WARMSTART VERSION XX.XX.XX 
- NUMBER OF BAD SECTORS = 0 


Enter: RY DMA 
system displays: 
DMA DISKA 0 FILES OPEN 


Format 3: LIST 


<sector address> “—” <sector address > 
DSKUTL LIST A < sector address > < number of sectors > i eee 
ky 
Aor N Alpha character listing or numeric (hex) listing can be specified by the use 


of this option in the initiating message. The default is both alpha and 
numeric in the same format as for the CMS LIST utility. 


sector address — This field specifies the sectors to be listed and consists of two decimal 
sector address numbers separated by a hyphen. The sectors listed will include the starting 
and ending sector number. 
Example: <1-20> causes sector numbers 1 through 20 to be listed. 


sector address This option also specifies the number of sectors to be listed and can be 
number of sectors used as an alternative to the above format. The number of sectors 
specified by the second decimal number will be listed, starting at the 
sector address specified by the first decimal number. 
If sector zero (0) is specified for listing, then the following is written to 
the printer following the content of sector 0: 


Sector Address Length Directory 
32/@0020@ 65/@0041@ AVAILABLE TABLE 
97/@0061@ 91/@0058@ NAME LIST 

188/@00BC@ 1001/@03E9@ DISK FILE HEADERS 

0/@0000@ 0/@0000@ PSEUDO PACK 
IDENTIFICATION 
TABLE 


The above sample output is from the disk reformatted with the parameters 
given in the example DSKUTL RF function above. If the disk-label is not 
in CMS format, this portion of the listing is omitted. 


Operation 

The utility causes a disk to be opened unlabelled, and prompts the operator to reserve and assign the 
appropriate disk drive or unit. On assigning the device, the utility lists the specified sectors and goes 
to EOJ. The drive must now be made ready by the operator before normal access can be made to 
the disk. 

Example: 

To list the first 10 sectors of the disk reformatted in the sample DSKUTL RF function above: 


Insert disk ‘‘DISKA”’ in drive DMA. 
The system displays ‘SDMA DISKA/ 0 FILES OPEN’’ 
Enter ‘“‘DSKUTL LIST 0 10”’ 
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or 
“DSKUTL LIST 0 -— 9” 


The system displays: 


PLEASE RESERVE (RD) DRIVE, THEN INSERT DISK FOR LIST AND THEN ASSIGN (AD) 
DRIVE 


Enter: RD DMA 
The system displays ‘‘DMA RESERVED 0 FILES OPEN’’ 
Enter ‘SAD <mix-number> DMA’’ 


The utility now lists the specified sector numbers and goes to EOJ. 
Format 4: COPY (B 90/B 900 Only) 


DSKUTL—— COPY al TO —— < output disk-id > JG 


TO disk-name For the COPY function, this option in the initiating message causes the 
disk-name specified to be written to the disk-label of the output disk if 
the input disk is in CMS format. 

If the input disk is not in CMS format or is a fixed disk with a pseudo- 
pack PPIT, this name is ignored when writing the disk-label. 

If no disk-name is specified in the initiating message, the disk-label is 
copied from the input disk to the output disk. 


Operation 
On commencing execution, the utility displays the message: 


““PLEASE RESERVE (RD) DISK, THEN INSERT INPUT DISK FOR COPY AND THEN AS- 
SIGN (AD) DRIVE’”’ 


The operator must now reserve and assign the disk drive required for input. The utility displays the 
message: 


““PLEASE RESERVE (RD) DISK, THEN INSERT OUTPUT DISK FOR COPY AND THEN AS- 
SIGN (AD) DRIVE’”’ 


The operator must now reserve and assign the disk drive or unit required for output. 


The utility checks that both input and output disks are SDI disks of the same type and capacity. Hav- 
ing established this, the utility proceeds to copy each sector of the input disk to the output disk. 


If an error which cannot be corrected is detected, the operator is informed of the sector(s) in error 
and the utility continues until the entire disk is copied. 


From Release 3.04, only BSMII type disks may be copied using this function. The following messages 
are displayed by the utility if a 211 fixed disk (or any other type of disk other than BSMII) is AD’ed 
to the utility in the Copy function. The utility then goes to End of Job. 


COPY FUNCTION DOES NOT SUPPORT THIS TYPE OF DISK 
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input Disk Error Handling 


NOTE 
System delays may be experienced prior to the display of messages reporting 
input disk read errors. 


If more than 100 input disk sectors with read errors are detected, the utility displays the following mes- 
sages and then goes to End of Job. 


MORE THAN 100 HARDWARE ERRORS DETECTED ON DISK IN DRIVE <drive id> 


The utility reports the sector addresses of input disk errors as they are encountered. For CMS disks 
only, the utility also attempts to resolve any corrupt information which may have been copied to the 
output disk as a result of input errors. The utility assumes that the disk label and the sectors of the 
Disk File Header and Name List areas which were read successfully from the input disk contain valid 
information that is not corrupt. 


Example: 
To copy the disk ‘‘DISKA”’ to a second disk ‘“‘DISKB”’ 


Insert ‘““DISKA’”’ into drive DMA and the output disk into drive DMB 
Enter: DSKUTL COPY TO DISKB 
System displays: 


“DT NACH RPECERVE /P 
PLEASE ADOONVE {RD) DRIVE, THEN INSER 


SIGN (AD) THE DRIVE” 
“¢<mix-number >/DSKUTL PROGRAM SUSPENSION <28>” 
‘“ASSISTANCE REQUIRED FOR DISK FILE LIST, USE ‘AD’ TO ASSIGN DEVICE”’ 


Enter: RD DMA 
system displays: 
“DMA RESERVED 0 FILES OPEN’’ 


Enter: ‘AD <mix-number> DMA’”’ 
system displays: 
‘““PLEASE RESERVE (RD) DRIVE, THEN INSERT OUTPUT DISK FOR COPY AND THEN 
ASSIGN (AD) DRIVE”’ 
“* < mix-number > /DSKUTL PROGRAM SUSPENSION <28>”’ 
‘ASSISTANCE REQUIRED FOR DISK FILE LIST, USE ‘AD’ TO ASSIGN DEVICE”’ 


Enter: RD DMB 
system displays: 
‘DMB RESERVED 0 FILES OPEN’”’ 
Enter: ‘AD <mix-number> DMB” 
The utility now copies the disk and goes to end of job. 


Recommendations For Read/Write Errors 


If a read or write error is detected during the COPY function on either the input or output disk, the 
following procedure is recommended prior to using the output disk: 
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1. Produce a KA listing of the output disk. 
2. From the sector addresses displayed by the utility for the read/write errors, determine which 
files contain the errors. These files should be removed from the output disk. 


If the read/write error occurs in the disk directory area, the disk should not be used without re- 
initialization (or re-formatting if it is an SDI disk). 


Format 5: BOOT (B 90/B 900 Only) 


The BOOT function provides the facility to replace the bootstrap code in Track Zero of a CMS initial- 
ized disk without changing any other information contained by the disk. This allows the upgrading 
of disks with the latest level of bootstrap, without reformatting or initializing the disks with the subse- 
quent loss of any files present on the disks. 


The syntax of BOOT is: 


B900 
co 
DSKUTL BOOT == < disk-id > 
Lsoorsraar 7 <tt> t- curn> 
< disk-id > < COLDSTART > 
< disk-name > This is the name of the disk which is to have its bootstrap replaced. 
BOOTSTRAP <file- The bootstrap file name, if specified, is used by the utility instead of the 
name> default bootstrap filename of 0000000/CMSBOOT on a B 90 system or 
0000000/SYSINTBOOT on a B 900. 
<MTR> This option is only valid for disks which can already be used for MTR 
purposes. 


With <MTR> specified, the relevant bootstrap (as decided by the utility) 
is selected from the default or specified bootstrap file by the utility and 
copied to the specified disk. See BOOT Bootstrap Table. 


<COLDSTART > This option causes the COLDSTART bootstrap to be written into track 
zero. This is used to invoke the COLDSTART utility (see COLDSTART 
utility). 
NOTE 
The angled brackets around <MTR> and <COLDSTART> must be in- 
cluded in the initiating message. 


When the appropriate bootstrap has been successfully copied to the specified disk, the utility displays 
the following message and terminates: 


BOOTSTRAP ON DISK <disk-id> REPLACED 
BY <bootstrap-used> VERSION <version-number > 


where <Bootstrap-used> = CMS/WARMSTART if the CMS B 90 bootstrap was used, 
or 


B 900 system if a B 900 bootstrap was used, 
or 
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MTR if either MTR-CAELUS or MTR-BSMII was used, 
or 
COLDSTART if the COLDSTART bootstrap was used. 


<version-number> = The version number contained in the bootstrap code if one exists; otherwise 
the version number of the bootstrap file. 
<disk-name> = The name of the disk that the bootstrap has been copied to. 


NOTE 
If an MTR bootstrap has. been replaced by either CMS or BDS bootstrap, 
it is impossible to replace this new bootstrap by an MTR bootstrap. To re- 
place the CMS or BDS bootstrap by an MTR bootstrap, the disk must be 
initialized or reformatted with the MTR option. 

NOTE 
If MTR bootstrap on 5.25 inch disk is replaced by a non-MTR bootstrap, 
the MTR bytes in the disk label are not reset. This does not affect subsequent 
use of the disk as a CMS disk. 


Table 4-4. DSKUTL BOOT Bootstrap Table If MTR Specified 


Disk Type Bootstrap Selected 
B 90 B 900 


Default bootstrap file is 
0000000/SYSINTBOOT 


MTR — CAELUS 
MTR — CAELUS 


Default bootstrap file is 
0000000/CMSBOOT 


MTR — CAELUS 
MTR — CAELUS 


1 MB Mini 


Cartridge (100 TPI and 200 
TP) 


CMS 


201-I Fixed (single density) BDS 
201-I Fixed (dual density) Not supported BDS 
211 Fixed (all types) CMS BDS 
BSMII Mini MTR — SDI 


MTR — SDI 


In the case of the BSMII disk, the special test patterns required for MTR are re-written to the reserved 
disk areas. For Caelus disk, reserved disk areas are checked for readability before the bootstrap is cop- 
ied. 


Table 4-5. DSKUTL BOOT Bootstrap Table If COLDSTART Specified 


; Bootstrap Selected 
Disk Type B 90 B 900 


Default bootstrap Default bootstrap file is 0000000/ 
file is O0000000/ SYSINTBOOT SYSINTBOOT 
file is 0000000/ 
CMSBOOT 


COLDSTART 


BSMII Mini and 
IMB Mini 


Not Supported. 
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DSKUTL Reformat and Initialize Parameters — via Accepts 


Parameters for initialization or reformatting of a disk may be entered by Accepts by specifying: 


DSKUTL IN or DSKUTL RF 


in the initiating message with no other parameters. 


The following prompts for each parameter in both Initialize and Reformat functions are displayed by 


the utility, prefixed with: 


DSKUTL <IN> or DSKUTL <RF> 


Parameters entered by AX are checked for legality and the utility re-prompts the user until a legal re- 
sponse has been given for the particular parameter requested. 


Prompt 


ENTER THE NAME FOR THE DISK (UP 
TO 7 LEGAL CHARACTERS) 


DISK SYSTEM 


ENTER THE MAXIMUM NUMBER OF 
FILES THAT THE DISK SHOULD 
CONTAIN (A NUMBER LESS THAN 2805) 


ENTER THE SERIAL NUMBER FOR THE 
DISK (6 DIGITS) 


ENTER THE NAME OF THE DISK 
OWNER (UP TO 14 CHARACTERS 
DELIMITED BY ‘*’’) 


IS DISK FOR COLDSTART USE? ENTER 
Y OR N 


PLEASE RESERVE (RD) DRIVE, THEN 
INSERT DISK FOR IN OR RF AND THEN 
ASSIGN (AD) DEVICE 


DSKUTL Output Messages 


Description 


The user is requested to enter the disk name 
using the ‘‘AX’’ command. 


lf the utility is running on a fixed disk on 
B 900, ‘‘UNIT.FDA”’ may be entered instead of 
the name. 


The user is requested to enter the number of 
files that are going to be on the disk using the 
“*AX’’? command. 


The user is requested to enter a number of 6 
digits. It is advised to enter the serial number as 
it is on the medium. Use the ‘‘AX’’ command to 
enter the number. 


The user is requested to enter his name using the 
“AX” command. 


The user is requested to indicate whether or not 
this disk is going to be a coldstart disk. Enter Y 
or N using the ‘‘AX’’ command. Not applicable 
to B 1000. 


The user is requested to reserve the drive using 
the RD command. For example, RD DMA, then 
assign the drive using the AD command. For 
example, AD <mix-no of DSKUTL> DMA. 


NOTE 


Error messages relating to options IN, COPY, BOOT or UNIT.FDA are not 
relevant to B 1000 systems. If such a message is displayed on B 1000, check 


input. 
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Message 


—- HARDWARE ERROR 
DETECTED WHILE 
READING FILE <file- 
name > 


—-HARDWARE ERROR 
DETECTED WHILE 
READING LABEL ON DISK 
<disk name> 


—HARDWARE ERROR 
DETECTED WHILE 
READING PSEUDO-PACK 
TABLE ON DISK <disk- 
name > 


CANNOT RUN DSKUTL 


<disk name> IS NOT A 
PHYSICAL DISK. 


— <character-string> IS NOT 
VALID INPUT 


-LABEL OF DISK IS NOT 
CMS FORMAT, PLEASE 
USE DSKUTL IN OR RF 
IGNORE OPTION 


PLEASE RESERVE (RD) 
DRIVE, THEN INSERT 
DISK FOR <function> AND 
THEN ASSIGN (AD) 


—~HARDWARE ERROR 
DETECTED WHILE 
READING SECTOR 
<number> ON DISK IN 
DRIVE <drive-id> 


DISK IN DRIVE <drive-id> 
IS LABELLED <disk 
name>, PLEASE ENTER 
OK IF <function> IS TO 
CONTINUE 


—ONLY FIXED DISKS 
MAY BE USED FOR A 
FIXED DISK SYSTEM 


DISK IN DRIVE <drive-id> 
WILL BE REFORMATTED 
AS PHYSICAL DISK <disk 
name> 
2032801 


Possible Causes 


The utility has encountered 
an error from which it 
cannot recover. 


The utility has encountered 
an error while reading the 
label of the specified disk. 


The utility has encountered 
an error while reading the 
PPIT of the specified disk. 


The utility cannot run. The 
reason is given in the second 
message displayed. 


An attempt was made to run 
DSKUTL on a pseudo-disk. 


The input to the utility is 
not what it expected. 


IGNORE was not specified 
in the initiating message and 
the disk being reformatted 
does not contain a CMS 
format label in sector 0. 


Self-explanatory. 


The utility has encountered 
an error while reading the 
specified sector on the 
specified disk. 


The utility has found a disk 
with the specified name, 
enter “‘OK” if DSKUTL 
should use the specified disk. 


UNIT.FDA was specified 
and a disk other than a 201- 
I or 211 has been AD’ed to 
the utility. 


Self-explanatory. 


Suggested Action 


Check integrity of the specified 
disk. 


Check integrity of the specified 
disk. 


Check integrity of the specified 
disk. 


Examine the reason given in the 
second message. 


Check input and re-enter. 
Correct input. 


Use IGNORE option. 


Use RD to reserve and AD to 
assign drive. For details of AD 
and RD see appropriate section. 


Check integrity of the specified 
disk and replace media if 
necessary. 


Enter ‘‘OK’’ to continue 
DSKUTL or nothing to stop 
DSKUTL. 


Check input and re-enter. 


None. 
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Message 


—HARDWARE ERROR 
DETECTED ON TRACK 0 


—HARDWARE ERROR 
DETECTED ON MTR 
SECTOR <number> 


—~BOOTSTRAP FILE <file- 
name> NOT CMS 
STANDARD 


—HARDWARE ERROR 
DETECTED WHILE 
READING DIRECTORY 


—DIRECTORY IS NOT 
VALID, PLEASE USE 
DSKUTL IN OR RF 
IGNORE OPTION 


-TOO MANY BAD 
ENTRIES IN THE 
AVAILABLE TABLE, 
PLEASE USE DSKUTL IN 


—NO SPACE ON DISK TO 
ALLOCATE DIRECTORY 
FOR SPECIFIED NUMBER 
OF FILES 


UNABLE TO <function> 
DISK IN DRIVE <drive-id> 


—BOOTSTRAP IS 
<bootstrap-name> VERSION 
<version id> 


—NUMBER OF BAD 
SECTORS IS <number> 


—PLEASE RUN 
CHECK.DISK ON <disk- 
name> WHEN READY 


DISK IN DRIVE <drive-id> 
REFORMATTED AS <disk- 
name> 


SECTOR(S) FROM <sector 
number> NOT LISTED, 
BEYOND END OF THE 


bh 


(continued) 
Possible Causes 


The utility is unable to read 
or write to one or more of 
sectors 0-31. 


The utility is unable to read 
or write to an MTR sector. 


The bootstrap file is not the 
one expected by the utility. 


The utility has encountered a 
read error on the directory 
of the disk being 
reformatted. 


Self-explanatory. 


The utility has found more 
than 90 bad entries in the 
disk being reformatted. 


The utility cannot find an 
available area large enough 
to accommodate the 
directory as specified. 


The utility is unable to IN 
or RF the disk in the 
specified drive. The reason is 
given in the next message 
displayed. 


Normal! output to tell which 
bootstrap is used. 


Normal output to tell how 
many sectors are unusable. 


Normal output after an RF. 


Normal output to indicate 
the successful reformat. 


The specified sectors are not 
valid for the specified disk. 


Suggested Action 


Replace disk medium. 


Replace disk medium. 


Copy a good version of the 
bootstrap file. 


Use DSKUTL IN to initialize the 
disk, or on B 1000 use stand-— 
alone PACK.INIT or 
CART.INIT. 


Re-run the utility with the 
IGNORE option. 


Use DSKUTL IN, or on B 1000 
use stand-alone PACK.INIT cr 
CART.INIT. 


Check input and re-enter with 2 


smaller number of files. 


See second error message for 
reason. 


None. 


None. 


None. 


None. 


Check input and re-enter. 


Message 
DISK IN DRIVE <drive-id> 


PLEASE RESERVE (RD) 
DRIVE, THEN INSERT 
INPUT DISK FOR COPY 
AND THEN ASSIGN (AD) 


NNIWUH 
VNIVE 


PLEASE RESERVE (RD) 
DRIVE, THEN INSERT 
OUTPUT DISK FOR COPY 
AND THEN ASSIGN (AD) 
DRIVE 

— DISKS IN DRIVE <drive- 
id> AND <drive-id> ARE 
DIFFERENT 


—HARDWARE ERROR 
DETECTED WHILE 
WRITING SECTOR 
<number> TO DISK IN 
DRIVE <drive id> 


SPECIFIED DISK-ID FOR 
COPY IGNORED, INPUT 
DISK <diskname> IN 

DRIVE <drive id> HAS 


PSEUDO-PACK TABLE 


—MORE THAN <number> 
HARDWARE ERRORS 
DETECTED ON DISK IN 
DRIVE <drive-id> 


—CANNOT ADD 
PHYSICAL DISK TO 
SYSTEM 


SPECIFIED DISK-ID FOR 
COPY IGNORED, INPUT 
DISK IN DRIVE <drive-id> 
IS NOT CMS FORMAT 


<file-name> NOT COPIED 
TO DISK <disk-id> IN 
DRIVE <drive-id> 


UNABLE TO REPLACE 
BOOTSTRAP ON DISK 
<disk-id > 


—NO INPUT SPECIFIED 
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(continued) 
Possible Causes 


The utility asks for the input 
disk to be made available 
for copy. 


The utility asks for the 
output disk to be made 
available for copy. 


The AD’ed drives are of a 
different type. 


The utility has encountered a 
write error on the specified 
drive. 


The utilitv ca 


ae esa ¢ 


10t handle a 
disk with a PPIT. 


The utility has encountered 
more than 31 sectors with 
errors while trying to write 
the directory of a 1 MB 
mini disk or more than 49 
errors on any other type of 
disk. 


The utility cannot run RF to 
add physical disk to existing 
fixed disk system. 


An output disk-id has been 
specified in the initiating 
message and a non-CMS 
disk has been AD’ed for 
copying. 

The utility has encountered 
an error on the disk file 
header of the input disk. 


The specified disk is not 
suitable for the requested 
bootstrap. 


There was no reply in 
Tesponse to accept. 


Suggested Action 


Use RD <drive-id> to reserve 
and AD <mix-no> <drive-id> 
to assign the drive. 


Use RD <drive-id> to reserve 
and AD <mix-no> <drive-id> 
to assign the drive. 


Check correct devices have been 
AD’ed. 


Check integrity of output disk 
using KA utility. If necessary, re- 
initialize output disk. 


None. Utility limitation. 


Check output medium and replace 
if necessary. 


Check integrity of existing fixed 
disks. 


None. Information only. 


Check integrity of the input disk. 


The reason for this message is 
given in the second message 
displayed. 


Correct input and re-enter. 


4-85 


Message 


DISK IN DRIVE <drive-id> 
WILL BE INITIALISED AS 
PHYSICAL DISK <disk-id> 


DISK IN DRIVE <drive-id> 
INITIALISED AS <disk-id> 


— HARDWARE ERROR 
DETECTED WHILE 
INITIALISING DISK 


— INIT. TRACK 
COMMUNICATE NOT 
SUPPORTED 


ENTER THE MAXIMUM 
NUMBER OF FILES THAT 
THE DISK SHOULD 
CONTAIN (A NUMBER 
LESS THAN 2805) 


ENTER THE SERIAL 
NUMBER FOR THE DISK 
(6 DIGITS) 


ENTER THE NAME OF 
THE DISK (UP TO 7 
LEGAL CHARACTERS) OR 
“UNIT.FDA”’ IF DISK FOR 
FIXED DISK SYSTEM 


ENTER THE NAME OF 
THE DISK OWNER (UP TO 
14 CHARACTERS 
DELIMITED BY ‘*’’) 


—IN DOES NOT SUPPORT 
THIS TYPE OF DISK 


BOOTSTRAP NOT COPIED 
TO DISK <disk-id> IN 
DRIVE <drive-id> 


DISK <disk-id> IN DRIVE 
<drive-id> MAY NOT BE 
USED FOR MTR ROUTINES 


AREAS MAY BE MISSING 
FROM OISK <diskid> IN 
DRIVE -<driveitd> 


(continued) 
Possible Causes 


A fixed disk is being 
initialized as a part of a 
fixed disk system. 


Successful completion of 
initialize. 

The initialize routine has 
encountered an error. 


There is a mismatch between 
the utility and the MCP. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


A request was made to 
perform an IN on a disk 
pack. 


The utility has encountered 
an error while copying sector 
2-31 to the output disk. 


The utility has encountered 
an error while copying the 
MTR areas to the output 
disk. 


The utility has encountered a 
read error on the available 
table or a file header was 
found whose name list entry 
dees not correspond. 


The specified surface check 


Suggested Action 


None. 


None. 


For details see the other 
messages. 


Check that the utility and the 
MCP are of the right level. 


Use AX to enter number of files. 


Use AX to enter serial number. 


Use AX to enter disk name. 


Use AX to enter owner’s name. 


None. 


Check input disk. 


Check input disk. 


Run ‘‘SQ”’ <disk-name> 
VERIFY’’ on the specified disk 
after completion of the copy. 


None. 


Message 
<number> COMPLETED 
ON DISK IN DRIVE <drive- 
id> 


—PLEASE USE A VERSION 
OF BOOTSTRAP FILE 
WHICH CONTAINS A 
COLDSTART BOOTSTRAP 


CANNOT READ LABEL OF 
DISK IN DRIVE <drive-id>, 
WILL ASSUME DISK IS 
BEING INITIALISED FOR 
THE FIRST TIME 


—ONLY MINI DISK MAY 
BE USED FOR COLDSTART 


—IN FUNCTION IS VALID 
ONLY FOR B90 AND B900 
SYSTEMS 

—COLDSTART OPTION IS 
VALID ONLY FOR B90 
SYSTEM 


-DISK WAS NOT 
INITIALISED FOR USE ON 
A B90 OR B900 SYSTEM 


BOOTSTRAP ON DISK 
<disk-id> REPLACED BY 
<type> VERSION 
<version > 


IS DISK FOR COLDSTART 
USE? ENTER Y OR N 


—DISK WAS NOT 
INITIALISED FOR MTR 
USE 
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(continued) 
Possible Causes 
is completed. This message 
will appear three or four 
times depending on the type 
of disk to be initialized. 


A request has been made to 
initialize or reformat a disk 
for coldstart use, but there 

is no valid bootstrap on the 
disk. 


Sector zero of the disk being 
initialized is not recognized 
by the utility. 


An attempt was made to 
replace the bootstrap of a 
non mini disk by a coldstart 
bootstrap. 


An attempt was made to use 
the IN function on a 


m taann 


B lyuu. 


An attempt was made to use 
the coldstart option on a 
system other than B 90. 


An attempt was made to 
replace the bootstrap on a 
disk which was not 
initialized on a B 90 or 

B 900 system. 


Successful replace of the 
bootstrap. 


Self-explanatory. 


An attempt was made to 
replace the bootstrap by an 
MTR bootstrap but the disk 
is not in a suitable state to 
accept that. 


Suggested Action 


Copy a good version bootstrap 
from a back-up disk. 


None. Information only. 


Correct input and re-enter. 


Use CART.INIT or PACK.INIT 
to initialize a cartridge or a pack 


aw - PD 10OnN 
OllL a D izvUU. 


None. Utility limitation. 


None. 


None. 


Use ‘‘AX”’ to enter Y or N. 
Initialize the specified disk with 


Initialize the specified disk with 
the MTR option. 
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DUMP (Dump Files from Disk to a Library Tape) 
(LD — TAPE LIBRARY UTILITY) 


This function is part of the utility LD. DUMP which provides the capability of copying files or groups 
of files from the disk specified by disk-name. If no disk-name is specified, then the system disk is as- 
sumed. 


Railroad diagram: 


Be DUMP & CHECK UPDATED PRINT.DIR TO <tape-name > ———> 


< file-name > 


FROM —— < disk-name > 


<BOTH > 


< family-name > 


NOTE 
A purged tape must be on line and ready for use by this utility. Purged tapes 
can be produced using either the PG or SN intrinsics on an on-line and ready 


tape. 
& CHECK If & CHECK is specified, CHECKADUMP will be zipped (without 
pause and display) from LD when the dump operation is completed. 
UPDATED If UPDATED is specified, only updated or newly created files will 


be dumped, that is, files with the ‘‘Modified’’ bit in the DFH set. 
(An LR listing will identify which files have the bit set.) Refer to 
Archiving using UPDATE Facility for a fuller explanation. 


PRINT.DIR If PRINT.DIR is specified, an accurate tape directory is printed at 
the end of the dump. The list of files is the same as in the 
directory at the head of the tape. For each file dumped, a list of its 
attributes is printed. If any file is not dumped, the reason why will 
appear beside the name. When PRINT.DIR is specified, all messages 
of the form: 


‘‘<file-name> DUMPED”’ are suppressed. 


Displays will be limited to exception conditions, for example, if a 
file cannot be dumped or loaded for some reason. 


TO <tape-name> This is the name which is given to the tape. 


FROM <disk-name> If the option FROM disk name is specified, the files are dumped 
from the disk named <disk-name>. If this option is not used, then 
the system disk is assumed. 


<file-name> <family- This is the file or family of files to be dumped to tape. Groups of 

name> files may be dumped by separating the file names or family names 
by a comma “‘,’”’ or a space “© ”’. 

<BOTH> If <BOTH> is specified immediately following a request to dump a 


key file then, provided that the pertinent data file is on the same 
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disk, the data file following the key file on the tape will also be 
dumped. 


Since the DUMP function is part of the utility LD, ‘‘LD”’ is actually what appears in a mix message. 
To discontinue the DUMP function, ‘DS <mix-number>/LD”’ must be used. 


Examples: 


Example 1. To copy all the files in the family named TEST from the system disk to a 
tape named TPTEST, the following initiating message is used: 


LD DUMP TO TPTEST TEST = 
Example 2. To copy all the key and data file pairs in the family MILK, which have 
been created or updated since the last time they were saved, onto tape or 


disk from the user disk DKMILK to the tape named TPMILK, the 
following initiating message is used: 


LD DUMP UPDATED PRINT.DIR TO TPMILK FROM DKMILK 
MILK= <BOTH> 


The addition of the keyword PRINT.DIR produces an accurate directory 
at the end of the dump. 


Example 3. To copy the files ARCFILE1 and ARCFILE2 from the disk named 
ARCDISK to the tape named ARCTAPE, the following initiating message 
is used: 


LD DUMP & CHECK TO ARCTAPE FROM ARCDISK ARCFILEI, 
ARCFILE2 


The addition of the keyword & CHECK causes the utility CHECKADUMP 
to be executed after the dump is successfully completed. 


NOTE 
For details of the creation of a Coldstart tape for a B 90 system, refer to 
the COLDSTART utility. 
Output Messages 


For output messages, refer to LD utility. 
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DUMPADISK (Disk Dump) 


The DUMPADISK utility is provided to enable periodic back-up and retrieval of user files to disk. 
The utility executes under MCP control and requires the open unlabelled disk facility in order to run. 
The B 90 MCP level 3.04 and above supports this function. DUMPADISK also requires the presence 
of the local language file (SYSLANGUAGE). 


All reference to pseudo-pack is for information only. The B 90 system does not support pseudo-pack. 


NOTE 
DUMPADISK replaces the DD utility. The disk format created by DUMPA- 
DISK is unique and builds a non-standard disk directory. Disks created with 
the DD utility are NOT recognized by the DUMPADISK utility. As DD will 
not be issued for any releases after 3.03, users with disks created with DD 
must convert their back-up media to disks created with DUMPADISK. 


The files created with the DUMPADISK utility can only be accessed using the DUMPADISK LOAD 
or ADD function. These disks can, however, be duplicated using the DSKUTL COPY function (see 
the description of DSKUTL earlier in this section). Disks used for back-up must be pre-initialized in 
CMS format and must not contain any user daia. Any files existing on a disk written to by DUMPA- 
DISK will be lost when the DUMPADISK disk directory is written. 


The utility also creates a security record when DUMPing to back-up disks. This record must be present 
on any disk used for a LOAD function. 


DUMPADISK provides the facility to create one or a numbered sequence of back-up disks during one 
dump session. 


Example: 


In dumping files from a 2011 disk to IMB disk, several IMB disks may be required to accommodate 
all the required data. During the DUMP or UNLOAD function, replacement disks will be called for 
as each back-up disk becomes full. The directory of each disk will contain entries for all the files con- 
tained on that disk, and disks which have been created previously in that dump session. Thus in a 
series of three back-up disks created in the same session: 


The directory of disk 1 has entries for all files on disk 1. 
The directory of disk 2 has entries for all files on disks 1 and 2. 
The directory of disk 3 has entries for all files on disks 1, 2 and 3. 


When retrieving files from back-up disks, all files DUMPed may be LOADed successively, or a selec- 
tion of individual or groups of files may be LOADed. In all cases, it is advisable to initiate any LOAD 
from the last disk of the sequence. In this way, if any files required for LOAD are not resident on 
that disk, the utility will call by name for the disk which contains those files. 


When creating back-up disks, the utility will request a four-character prefix for disk identification pur- 
poses. Each disk created will be labelled with this prefix concatenated with a three-character decimal 
number, progressing from 001 to 999. During subsequent retrieval, all disks will be called for by their 
seven-character label (user-specified prefix plus decimal suffix). Back-up disk labels (sector 0) are cre- 
ated in CMS format. 


Files can be DUMPed to and LOADed from any CMS supported removable disk media (except 
ICMD), and DUMPed or LOADed from and to any CMS supported disk. 
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The new “& CHECK’ option can be specified, which causes the utility to compare copies of files 
DUMPed or LOADed with the originals. If any discrepancies are discovered, the new copy will not 
be made permanent. 


Format: 


Format 1 
DUMPADISK PRINT.DIR 


This function lists the disk directory. 


Format 2 


i PRINT.DIR 7 = LOAD & CHECK 
DUMPADISK ADD oe ee nea nes oman) 
p— FROM <disk-id > — f— TO <disk-id > —4 ee 


< filetist > —+———$— > 


where <file-list > is defined as : 


< family-id > < BOTH > 
aie os Ei eet es 


This function enables back-up disks to be created together with the option to print the directory of 
the complete dump session. 


Format 2 dumps files, or groups of files, from a disk to a backup disk, or a series of backup cisks. 
Each backup disk must be made available to the utility via an AD command (note the disk must have 
been reserved using the RD command), when the utility attempts to open an unlabelled disk file. If 
the option PRINT.DIR is specified, at the normal EOJ the utility prints the directory of the files 
dumped during this current session. 


If the UPDATED option is specified, only files specified in the < file list> which have the UPDATED 
bit set in their Disk File Header (DFH) are dumped. 
NOTE 
See Archiving Using UPDATE Facility for a fuller explanation. 


Use of the DUMP option will copy a file or files to backup medium only. Using the UNLOAD option 
will copy a file or files to backup medium and remove the original copy from disk. 
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Format 3 


PRINT.DIR DUMP & CHECK 
DUMPADISK eae AS NaN J el (a Ce (Ee 
UPDATED FROM < disk-id > 


where < file list > is defined as : 
< family name > ] Eanes > z] 
< file name > 
This function enables retrieval of backed-up files to any named disk. 


Format 3 loads back files from a named disk to a named disk. The input disk must have been created 
previously by DUMPADISK in order for the files to be loaded. ADD only loads files if they are not 
already present on the output disk. 


If the PRINT.DIR option is specified, a hard copy listing is produced at the end of the run, indicating 
whether or not the LOAD/ADD request on the file by file basis has been successful. 


NOTE 
Once a disk has been used as a dump disk, it must be reformatted or re- 
initialized before it can be used for any other purpose. 


For formats 2 and 3, <file-list> is defined as a comma-list of individual file-ids, family-names (for 
example, ABCD=), or just = to specify all files on a disk. 


NOTE 
If indexed pairs are to be DUMPed or LOADed, then the <BOTH> opticn 
must be included in the file-list following the indexed pair file-name. 


Formats 2 and 3 


&CHECK This option causes DUMPADISK to check each DUMPed or UNLOADed file 
against the original and if any data corruptions occur, the file in question will 
not be made permanent. 


Format 1: PRINT.DIR 


By specifying only PRINT.DIR in the initiating message, the utility prints the directory of the disk 
assigned to the utility. 


Operation 


The utility will open-unlabelled a disk and prompt the Operator to reserve (RD) and assign (AD) the 
disk drive containing the relevant disk. 


The utility orints the directory and goes to EOI. 
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Format 2: DUMP or UNLOAD 


PRINT.DIR This option in the initiating message causes the utility to print the 
directory of all files DUMPed during the session when it goes to EOJ. 


FROM disk-name This option allows the operator to specify the disk-name from which the 
files are to be DUMPed or UNLOADed. If this option is omitted from 
the message, the utility searches the system disk for the specified files. 

file-list This entry specifies the individual files or groups of files to be DUMPed 
or UNLOADed. The form of this entry can be a commaz-list of individual 
files, a comma-list of file families (FILE=), or just = to DUMP all files 
from the specified or default disk. 

UPDATE DUMPADISK will DUMP/UNLOAD only the files which have been 
modified if the keyword UPDATED is used in the initiating message. 


Operation 


On executing, the utility first builds an internal directory or list of files to be DUMPed, and then dis- 


plays the message, if the name was not given in the initiating message in the TO option. 


“PLEASE ENTER A FOUR CHARACTER DISK NAME WHICH WILL BE USED TO IDEN- 
TIFY YOUR DUMP DISKS” 


The operator must now enter the prefix usin 
The operator is now prompted to Reserve (RD) and Assign (AD) the disk drive in which the output 
disk is located. If the current disk is filled before the DUMP is complete, the operator is informed 
that it is OK to PO drive <Dxy>. The utility then prompts the operator to replace the disk by display- 
ing the following message: 


_— PLEASE POWER OFF DISK IN DRIVE <drive-id> 
— PLEASE INSERT AND ASSIGN (AD) NEXT DISK TO CONTINUE THE DUMP 


The operator must PO the existing disk and replace it with another disk. 


On completing the DUMP, if the PRINT.DIR option was entered in the initiating message, the direc- 
tory for the dump session is output to the line printer before the utility goes to EOS. 


Format 3: ADD or LOAD 


FROM disk-id This entry specifies the back-up disk-id from which files are to be 
LOADed or ADDed. When entering this name for a sequence of back-up 
disks, the name of the last disk in the sequence should be used. If the 
specified files contained in the <file-list> option of the initiating message 
are not on this disk, the utility will call for the required disk by name. 


TO disk-id This option allows the operator to specify the disk to which files are 
LOADed or ADDed. 
file-list This entry specifies the individual files or groups of files to be LOADed 


or ADDed. The form of this entry can be a commaz-list of individual files, 
a commaz-list of file families (FILE=) or just = to indicate a LOAD of 
all files on the specified disk. 
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SF 
Operation 


The disk from which the ADD or LOAD is to take place must be READY before entering the initiating 
message. 


If any of the specified files for LOADing are not resident on the disk, the available files are LOADed 
and the utility prompts the operator to supply the required disk. When all files have been LOADed 
or ADDed, the utility goes to EOJ. 


NOTE 
Files will only be ADDed if there is no file of that name already on the disk 
being ADDed to. A LOAD will replace existing files. 


Error Recovery 


If a read/write error is detected during DUMPing, the utility automatically attempts to reallocate disk 
space for the file currently being DUMPed. This process is repeated up to ten times for each file on 
any one disk. If a parity error is detected when attempting to write to a newly re-allocated area of 
disk, then the utility attempts to write to another area and ignore the previous attempt. Therefore, 
the utility attempts to re-allocate up to ten non-contiguous areas per file on each disk. If this limit 
is reached, the dumping of the current file is terminated (see the following list of error messages. The 
utility continues by dumping the next file, if there are any more to be dumped. 


If an error is detected during a multifile ADD or LOAD, the utility terminates the LOAD for that 


file and continues to ADD or LOAD remaining files. 


If a read/write error occurs in the directory area of a disk, the utility terminates. 


Output Messages 
Message 
<file-id> LOADED 
<file-id > DUMPED 
<file-id> NOT LOADED 
<file-id> NOT DUMPED 
<family> NOT LOADED 


<family> NOT DUMPED 


— ASSOCIATED DATAFILE 
<file-id> NOT FOUND 
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Possible Cause 


Normal operation. File with 
name <file-id> is 
successfully loaded. 


Normal operation. File with 
name <file-id> is 
successfully dumped. 


Specified file is not loaded. 
The reason is given in the 
second message displayed. 


Specified file is not loaded. 
The reason is given in the 
second message displayed. 


Specified family is not loaded. 
The reason is given in the 
second message displayed. 


Specified family is not loaded. 


The reason is given in the 
second message displayed. 


The <BOTH> option was 
used, but the datafile of an 


Suggested Action 
None. 


None. 


Look for the reason in the 
second message given. 


Look for the reason in the 
second message given. 


Look for the reason in the 
second message. 


Look for the reason in the 
second message. 


Check the input-disk for the 
presence of the specified files. 


Se Sg a eS SS SS 


Message 


—INCONSISTENT FILE 
SIZE AT DUMP TIME 


~—FILE IS OPEN SHARED 
OR FOR OUTPUT USE 


—FILE HAS BEEN 
ALTERED 


—FILE HAS NOT BEEN 
UPDATED 


— INTERMITTENT 
HARDWARE ERRORS 
DETECTED ON DISK 
< disk-id > 
—~HARDWARE ERROR 
DETECTED WHILE 
WRITING TO DISK <disk- 
id> 

—REQUESTED FILES 
WERE NOT FOUND 


—HARDWARE ERROR 
DETECTED WHILE 
READING DISK <disk-id> 


—FILE IS ALREADY ON 
DISK 


—ASSOCIATED DATAFILE 
IS ON ANOTHER DISK 


—FILE WAS NOT 
SUCCESSFULLY DUMPED 


INCORRECT INPUT TO 
DUMPADISK 
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(continued) 
Possible Cause 


indexed pair cannot be found. 


The keyfile is not DUMPed. 


DFH file-size and number of 
records DUMPed or LOADed 
are not equal. 


Another program is using the 
specified file. 


The file specifications have 
been changed since the utility 
was started. 


The UPDATED option is 
specified for a file which has 
not been updated. 


Write error which cannot be 
resolved has occurred during 
dumping of files. 


The utility has encountered a 
write error on the output 
disk. If the utility continues, 
it has been able to recover. 


The specified files are not in 
the directory of the specified 
disk. 


The utility has encountered a 
read error on the input disk. 
If the utility continues, it has 
been able to recover. 


The specified filename already 
exists in the directory of the 
disk. 


The datafile of an indexed 
pair is not on the specified 
disk. The utility will continue, 
but the keyfile is not 
LOADed. 


The specified file is not 
dumped because the file has 
changed or moved since the 
start of the utility. 


There is an error in the 
initiating message. The 
explanation is given in the 
second message displayed. 


Suggested Action 
Re-run the utility. 


Investigate discrepancy and re- 
run the utility. 


Wait for the file to be released 
by the program. 
Check status of file not dumped 


and re-run the utility. 


Check status of file not 
dumped. 


Use another disk 


None. 


Check initiating message for 
correct filenames. 


None. 


None. 


Check the initiating message and 
print the back-up disk directory. 


Check file status and re-run 
utility. 


Look for the explanation in the 
next sentence displayed by the 
utility. 
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Message 


—INVALID CHARACTER 
IN <identifier > 


—REQUEST IS 
INCOMPLETE 


-—FILE NAME <file-id> 
EXCEEDS 12 
CHARACTERS 


— <specified option> IS 
NOT A VALID OPTION 


—NO FILE NAME 
SPECIFIED 


~ PARAMETER 
FOLLOWING KEYWORD 
<string> IS INVALID 


—CANNOT HANDLE A 
REQUEST OF THIS 
LENGTH 


—IS NOT A VALID INPUT 


~ FROM EXPECTED 


—DISK NAME <disk-id> 
EXCEEDS 7 CHARACTERS 


—OPTION <specified 
option> HAS BEEN 
SPECIFIED MORE THAN 
ONCE FOR FILE <file-id> 


-—OPTION <specified 
option> HAS BEEN 
SPECIFIED MORE THAN 
ONCE FOR FILE <family- 
id> 

-DISK <disk-id> CANNOT 
BE ACCESSED FOR THIS 
RUN 


—NO DISK NAME 
SPECIFIED 
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(continued) 
Possible Cause 


One of the characters is 
outside the range A to Z, 0 
to 9, sos or eee Lan 


At least one word in the 
initiating message is missing 
or misspelled. 


The specified filename is more 
than 12 characters long. 


The UPDATED option is 
used in the initiating message 
for LOADing or ADDing. 


There is no file name 
specified in the initiating 
message. 


The utility has encountered an 
error in the initiating message. 


The input message exceeds 
601 characters. 


There is an error in the 
initiating message. 


The utility expects the word 
FROM when ADDing or 
LOADing. 


The diskname <disk-id> in 
the initiating message is too 
long. 


At least one of the options 
occurs more than once in the 
initiating message. 


At least one of the options 
occurs more than once in the 
initiating message. 


There is a diskname specified 
in the file list which is not 
the same as the name 
following the FROM option. 


There is no diskname 
specified after the word 
“TO”? or “FROM”, 


Correct 


Correct 


Correct 


Correct 


Correct 


Correct i 


Correct 


Correct 


Correct 


Correct 


Suggested 
input and 


input and 


input and 


input and 


input and 


input and 


input and 


input and 


input and 


Action 
re-enter. 


re-enter. 


re-enter. 


re-enter. 


re-enter. 


re-enter. 


re-enter. 


re-enter. 


re-enter. 


Check input and correct. 


Check input and correct. 


Correct input and re-enter. 


Correct input and re-enter. 


eee Lk 


Message 


~FILE HAS BEEN 
REMOVED 


—FILE IS CURRENTLY 


BEING USED BY 
ANOTHER PROGRAM 


—~HARDWARE ERROR 
DETECTED WHILE 
WRITING TO FILE <file- 
id> 

—~ HARDWARE ERROR 
DETECTED WHILE 
READING FILE <file-id> 


—HARDWARE ERROR 
DETECTED WHILE 
READING PSEUDO-DISK 
TABLE ON DISK <disk-id> 


—DISK <disk-id> DOES 
NOT BELONG TO THIS 
LOAD 


~DISK <disk-id> IS NOT 
RECOGNIZED BACKUP 
DISK 


—HARDWARE ERROR 
DETECTED ON 
DIRECTORY OF DISK 
< disk-id > 


—~UNLABELLED OPEN 
HAS NOT BEEN 
IMPLEMENTED ON THIS 
SYSTEM 


<file-id REMOVED 


—~NO FILES TO <DUMP/ 
LOAD> 


—~DUMPADISK CANNOT 
HANDLE MORE THAN 
2804 FILES, LIMIT 
REACHED AT FILE <file- 
id> 

—FAMILY MAY BE 
INCOMPLETE 
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(continued) 
Possibie Caiise 


The utility is unable to dump 
the file while it is removed. 


The specified file is not 
available because another 
program is using it. 


The utility has encountered a 
write error on the output disk 
from which it cannot recover. 


The utility has encountered a 
read error on the input disk 
from which it cannot recover. 


An error is encountered 
during a read on the PPIT of 
the specified disk. 


The newly inserted disk is not 
a part of the group of disks 
to be LOADed. 


The directory of the specified 
disk is not of a type 
dumpadisk uses. 


The utility found an error 
from which it cannot recover 
on the directory of the 
specified disk. 


The utility is used with an 
incompatible level of system 
software. 


The utility has found a 
duplicate filename during a 
LOAD, or removes the file as 
a result of an UNLOAD. 


None of the files specified in 
the initiating message is 
suitable for DUMPing or 
LOADing. 


A request was made to 
DUMP or LOAD more than 
2804 files. 


Some of the requested files 
are on a pseudo-disk, 


Suggested Action 


Check status of files not 
dumped and re-run the utility. 


Wait until the other program 
has finished, then re-enter. 


Check output medium. 
Check output medium. 


Check integrity of specified disk. 


Check the disks to be LOADed 
and re-enter. 


Check the disks to be LOADed 
and re-enter. 


Check integrity of specified disk. 


Check the system software is of 
level 3.4 or higher. 


None. 


Check input and re-enter. 


Check input and divide the files 
to be loaded or dumped into 
two groups. 


Ready the disk and re-enter. 
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Message 


—FAMILY FOR <family- 
name> MAY BE 
INCOMPLETE 


COMPARISON ERROR 
DETECTED WHILE 
CHECKING <file-id> 


—ERROR OCCURRED AT 
RECORD <number> 


~ DISK FILE HEADERS DO 
NOT MATCH 


—PLEASE POWER OFF 
DISK IN DRIVE <drive-id> 


—PLEASE INSERT AND 
ASSIGN (AD) NEXT DISK 
TO CONTINUE THE DUMP 


—PLEASE POWER OFF 
DISK <disk-id> 


— PLEASE INSERT DISK 
<disk-id> TO CONTINUE 


DISK <disk-id> IS NOT 
REQUIRED FOR THIS 
LOAD 


—PLEASE MAKE DISK 
<disk-id> AVAILABLE 
AND ENTER OK, OR 
MAKE ANOTHER DISK 
AVAILABLE AND ENTER 
ITS NAME 


—PLEASE ENTER A FOUR 
CHARACTER DISK NAME 
WHICH WILL BE USED 
TO IDENTIFY YOUR 
DUMP DISKS. 


—INSUFFICIENT AREA TO 
DUMP TO ON DRIVE 
<drive-id > 


—DISK LABEL OF <disk- 
id> IS NOT CMS FORMAT 
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(continued) 
Possible Cause 
pertaining to a physical disk 
which is not ready. 


Some of the requested files 
are on a pseudo-disk 
pertaining to a physical disk 
which is not ready. 


The ‘‘& CHECK”? option has 
been specified and a 
discrepancy has been found. 


Self-explanatory. Further 
explanation is given in next 
sentence of message. 


A comparison error has been 
found on the directory of the 
file. 


The current disk is full during 


DUMPing. 
Self-explanatory. 


The current disk has been 
LOADed. 


Self-explanatory. 


The files to be loaded do not 
reside on this disk. 


Information only. An 
additional disk is required to 
continue the LOAD. 


The name of the dump disk 
has not been entered in the 
initiating message. 


After dumping tke directory 
of files there is no room left 
to dump anything else. This 
disk cannot be used for 
dump. 


The label of the specified disk 
is not in a recognized CMS 


Suggested Action 


Ready the disk and re-enter. 


Look at second sentence of 
message to find reason for 
error. 


Check file integrity. 


Check disk integrity. 


Use “PO” to power off the 

specified drive. 

Insert new disk and use ‘“‘AD 
<mix-no> <drive-id>’’ to 

continue. 


Use ‘‘PO”’ to power off the 
specifiec drive. 


Insert requested disk. 


Look at the second message 
given for the disk name 
requested by the utility. 


Insert requested disk. 


Use ‘“‘AX <mix-no> <4 char. 
disk-id>’’ to inform the utility 
of the name of the dump 
prefix. 


Use a larger type of disk to 
dump the specified files. 


Check the integrity of the 
specified disk. dump the 


. 6 re 


Message 
DUMP TO ON DRIVE 
< drive-id > 


—DISK LABEL OF <disk- 


id> IS NOT CMS FORMAT 


—FILE HAS NOT BEEN 
CHECKED FOR 
COMPARISON ERRORS 


END DUMPADISK 
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(continued) 

Possible Cause 
format. of files, there is no 
room left to dump anything 
else. This disk cannot be used 
for dump. 
The label of the specified disk 
is not in a recognized CMS 
format. 
The file is split over two 
back-up disks and cannot be 
compared. 


Normal message when 
DUMPADISK is at End Of 
Job. 


Suggested Action 
specified files. 


Check the integrity of the 
specified disk. 


None. 


None. 
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DUMPANALYSE 


The DUMPANALYSE utility is for use by CMS COBOL, RPG and MPL programmers. It provides 
a method of obtaining B 90 and B 1000 program dumps from programs that have been abnormally 
terminated and gives an analysis to be used as an aid to locating logic errors. 


The dump may be analyzed remotely if the interactive dump analyzer is executing in a datacomm envi- 
ronment via a menu interface. If it is executed in a non-datacomm environment, a complete analysis 
to the printer will be performed. 


To understand a program dump, the user must be familiar with the basic concepts of CMS and with 
the s-code of the language in which the program is written. This is described in the CMS MCP Refer- 
ence Manual (form number 2007555). 

NOTE: 


1. This DUMPANALYSE utility is common to B 90 and B 1000 systems. For B 900 systems, refer 
to section 9 ‘‘B 900/CP 9500 Dependent System Software’’. 

2. To understand a program dump, a compilation listing of the program must be available. 

3. Setting certain dollar options during compilation helps in reading program dumps. These dollar 
options are discussed iater. 


Obtaining the Dumpfile 


When a program encounters an execution time error, a DS/DP message occurs and a dump file can 
be created by the DP command: 


DP <mix-number > / <program-name> 


Alternatively, if a program is known to be looping, a DP of the program can be forced in order to 
identify the conditions associated with the loop. 


On B 1000 systems only: 

The DM command may be used to create a dump of a running program. To do this, enter: 
DM <mix-number>/<program-name>. 

When the dump file has been created, the program is suspended. To re-start the program, enter: 
GO <mix-number> 


The dump file created is named DMFILnn, where nn is a two digit decimal number representing the 
mix-number of the DP’d task. 


The dump file contains the program parameter block (PPB) of the code file of the executing program, 
the overlayable segments of code and data, and certain memory tables used by the MCP for this task 
(the locked slice). 

Initiating The Analysis 

Initiating Interactive Analysis 


If the enaly 


zer (s rum in a datacomm environment and remote analysis is required, the initiating mes- 


ee aa nee EERE 


ou: OLIMPANALYSE 


ea Ze be Ae 
rede et lee 


os : aec, che user is required to enter the dump file name. If an invalid dump 


gic name is given, an error message will be displayed and the user has the opportunity to re-enter his 
information. 


If the dump file to be analyzed is found to be a COBOL or RPG program dump file, the next 
displayed will then aliow the codefile and/or namefile to be identified, so a. 
and/or Namefile Analysis respectively may be performed. 


Oleg Pet 


“2 -adefiie and namefile fields are blank, then no COP table or NAMEFILE analysis is avail- 


coe Tari fay 


eid ‘but. the analysis continues. 
B 1000 Systems 
Codefile field: 


The second screen that is displayed prompts the user to enter the codefile name. This field must not 
se left blank. 


zey displays the default codefile name that was recorded in the PPB when the program was 
she codefile name has changed, enter the new name in this field. 


If the specified codefile name cannot be found, a message is displayed and the analyzer remains sus- 
pended until a valid name is entered. The codefile contains information which is used by DUMPANA- 
LYSE, and must be on-line during the analysis. 


Namefile field: 
If this field is left blank, no namefile analysis is available for COBOL/RPG dumps, but the analysis 
corlimues. 


The entire interactive analysis is menu driven, so specific sections of the analysis may be examined re- 
motely by selecting the appropriate menu option. Prints of various sections or specific pages may be 
obtained, as well as a complete printed analysis, if required. 


Any error messages, resulting from invalid entries in any of the forms fields, are displayed between 
the menu list and the “SELECT MENU OPTION”’ entry, and the user may re-enter his information. 


Depending on the dump type, either an MPL menu page or COBOL/RPG menu page is displayed. 
Unless otherwise specified, screens and analyses are the same for both dump file types. 


The menu screens for B 90 and B 1000 systems are similar. However, where differences exist they are 
specified in the following table. 


Menu Explanation 
Option 
1 Terminates the session and displays the termination screen on the 
user’s terminal. 
2 Displays the screen containing the Program Parameter Block 
Information 
2032861 
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Ment Explanation 


ae Displays the screen containing the information of the S-Interpreter 
Work Area. 
4 COBOL/RPG Displays information about the PERFORMS and/or subroutines that 
were current at the time the dump was taken. 
MPL Displays the lexical level and the values of DISP containing a 
pointer to the data stack. 
5 COBOL/RPG Displays Current Operand Table (COP) Analysis including data item 
numbers and values. 
MPL Displays the data segments, starting from segment 0, in hexadecimal 
and ASCII. 
6 COBOL/RPG Displays list containing the namefile and Data Values if the namefile 
is supplied by the user. 
MPL Displays the Control Stack list. 
7 COBOL/RPG Allows the user to specify a particular FIB: 
For B 90 systems enter external filename. 
For B 1000 systems enter internal filename. 
If no FIB is specified, the analysis is given in the data segment table 
order. 
MPL Allows the user to examine the Data Stack Contents for a specified 


segment and procedure number. 
The default for PSN/SPN is the segment and procedure for the level 
at which the dump was taken. 


8 COBOL/RPG Allows the user to specify a particular data segment number. 
The default is ‘‘ALL’’ which starts analyzing the data segment 
number at segment zero. 
MPL Allows the user to specify a particular FIB. 
For B 90 systems enter the external filename. 
For B 1000 systems enter the internal filename. 
If no FIB is specified, the analysis is given in the data segment table 


order. 
9 Starts display of the unedited dump. 
10 COBOL/RPG Explains the Communicate Responses of the dump file. 
MPL Explains the Fetch Value of the dump file. 
11 Prints the complete dump in a format similar to that appearing on 


the screens. 
Initiating Non-Interactive Analysis 


DUMPANALYSE produces a printed analysis of this dump file. This is achieved by using the fol- 
lowing initiating message: 


DUMPANALYSE < disk-name dmf > / DMFIbLnn = es eae cee 


a SS 
> $NAMEDP —L < disk-name > / eae <file-name > aes SSAVEDMF tk SUNEDITED 


disk-name dmf 
DMFiLnn 
program-name 


$NAMEDP 


$SAVEDMF 


$UNEDITED 


This is the name of the disk on which the dump file resides. 

This is the name of the dump file. 

This is the. name of the program which was DP’ed, it is required for COP 
Table Analysis of COBOL/RPG programs. For analysis of B 1000 system 
dumps, either this filename or the default name, must be on-line. 

This dollar option is used with COBOL or RPG programs to provide 
source related dump analysis. Note that the COBOL or RGP program 
must be compiled with the relevant dollar options (see COBOL and RPG 
Dependent Dump Analysis). The name of the file which the compiler 
produced must be specified if this option is used. 

This dollar option will prevent DUMPANALYSE from removing the dump 
file when DUMPANALYSE has finished with it. 

This doliar option will cause DUMPANALYSE to generate only an 
unedited dump. 


NOTE 


If the program-name (codefile) is not specified and one is required, the de- 
fault is assumed. The default is set when the program is compiled. If the pro- 
gram-name has been changed, the new name must be specified. 


If the default codefile is not found: 


a nan 
— UH DIN 


avrae rraent 
sysicms a warning m 


e is displayed and the analysis continues. 


— On B 1000 systems a warning message is displayed and the utility terminates. 


Examples: 


The following sample initiating messages relate to a program called OBJECT.A, with an internal pro- 
gram-name of CODE.A. The mix-number of the program was 02 and the name of the file created 


by the dump is DMFILO2. 


For each example, the response for B 90 and B 1000 systems is given. 


1. DUMPANALYSE DMFIL02 


B 90 systems 


B 1000 systems 


— DUMPANALYSE produces the printed analysis of DMFILO2 and removes 
the dumpfile after use. 

— DUMPANALYSE terminates before any analysis is performed, because the 
default program-name was not found. The dump file is not removed. 


2. DUMPANALYSE DMFIL02 OBJECT.A $SAVEDMF 


B 90/B 1000 
systems 


— DUMPANALYSE produces the printed analysis of DMFILO2 including 
COP Table Analysis for COBOL/RPG dumps, for the file specified 
(OBJECT.A) 

The dumpfile is not removed after use because the $SAVEDMF was set. 


3. DUMPANALYSE DMFIL02 $NAMEDP COB.A.NAMES 


B 90 systems 


2032801 


— DUMPANALYSE produces the printed analysis of DMFILO2 including 
analysis of the file COB.A.NAMES. 

If the namefile is available, namefile analysis is listed. 

COP Table Analysis is not performed because the default program-name was 
not found. 
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ee 


B 1000 systems ~ DUMPANALYSE terminates before any analysis is performed because the 
default program-name was not found. 


4. DUMPANALYSE DMFIL02 OBJECT.A $NAMEDP COB.A.NAMES 
B 90/B 1000 ~ DUMPANALYSE produces the printed analysis of DMFILO2, including 
systems COP Table Analysis for the specified program-name (OBJECT.A). Analysis of 
the file COB.A.NAMES is also given. 
DUMPANALYSE removes the dumpfile after use. 


Analysis Common to All Program 
Languages — Interactive/Non-interactive Analysis 


The dump analysis is a reflection of the state of the interpreter and the state of the task itself. Some 
methods of representing the information on the listing are explained here. 


Each line of a hex memory dump is printed in the following format: 


<offset> <text> ‘‘<ASCII representation>”’ 


aed 
ae 
a 
o 
oa 
@ 
ad 
3 
@ 
3 
oO 
“a 
2. 
3 


The <offset> applies to the first byte and is relative to the base o 
printed. It is given in four digit hex and decimal representation. 


@10BC@/00444 


The <text> will consist of 16 hex byte values, divided into groups of four, for display on the screens, 
or 32 hex byte values when full printed analysis, is required. The <ASCII representation> is the 
ASCII character representations of the hex byte values in the line. Blanks are inserted where no such 
equivalent exists. For any sequence of lines which contains the same values, the first two lines are 
printed, followed by a single line with the text ““SAME AS LINE ABOVE?”’. 


The analysis listing is headed by a title the run date and the release level. Where source related dump 
analysis is used, the name of the related source file is also listed. The various sections are described 
as follows: 


Reason for Dump 
This is the decoded reason for the abnormal termination of the task. 
Program Parameter Block Information 


The fields of the Program Parameter Block (PPB) are decoded with the hexadecimal equivalent of the 
values printed beside these values. For a further explanation of the contents of the PPB refer to the 
CMS MCP Reference Manual (form number 2007555). 


Also contained in this section are several other fields of information. 


Dump File Name 


This gives the user the pack name on which the file resides and the file name of the dump file for 
later reference. 


Locked Location Start 


This is a pointer to the location of the code file’s locked slice. The value of this field is the dump 
file’s logical record number in which the start of the locked slice is located. 
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Task Name 
This is only available on the B 90 analysis 


This is a task originator identifier of the aborted task. A breakdown of this byte could be useful to 
the user. 


This byte is arranged as follows: 


most significant 3 bits : SOURCE field 
next 4 bits : TASK field 
least significant bit : TASK-FLAG 


i. The source field can have the following values and meanings: 
100 — The task was loaded as the result of a keyboard input message. 
001 — The task was loaded as the result of a ZIP from another task. 


2. If the TASK.FLAG is set, the TASK field contains the task-name of a task which is to be re- 
started when the current task reaches end-of-job. If the TASK.FLAG is reset, the TASK field 
is ignored and no task is to be restarted when the current task reaches end-of-job. 

3. If a task performs a ZIP with PAUSE of another task, the TASK field for the zipped task 
is loaded with the TASK field of the zipping task and the TASK-FLAG of the zipped task is 
set. If a task performs a ZIP without PAUSE, the TASK-FLAG of the zipped task is reset 
and the TASK field is ignored. 


Interpreter Preset Area 


Also listed for COBOL and RPG dumps are the contents of the EDIT table used to contain the editing 
constants for the program. This is an 8-byte field. 


File Information 
For each file associated with the task, the File Information Block (FIB) and File Parameter Block 


(FPB) are analyzed. The file-name is printed in the heading for each analyzed FIB. 


NOTE 
For B 90 systems the external file-name is printed. For B 1000 systems the 
internal file-name is printed. 


(Details of files and file attributes can be found in the CMS MCP Reference Manual, form number 
2007555). 


Unless otherwise specified, the FIB information is available for both B 90 and B 1000 systems. 


On the menu screen, option 7 or 8 may be used to request a specific FIB. If these options are used, 
specify the external file-name for B 90 systems and the internal file-name for B 1000 systems. 


NOTE 
Data comm is not handled on a file basis. 


Closed Files 


If the file was closed, or half closed, at the time of the dump, the following information is provided: 
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1. File Parameter Block Analysis. 
2. FIB segment number. 
This is the data segment number for the File Information Block. 


3. FPB segment number. 
This is the data segment number for the File Parameter Block. 


4. File state 
This specifies if the file was closed or half closed. 


Open Files 
If the file was open at the time of the dump, the following information is provided: 
1. File Parameter Block Analysis 


2. FIB segment number 
This is the data segment number for the File Information Block 


3. FPB segment number 
This is the data segment number for the File Parameter Block 


4. File state 


OPEN/CLOSE 

For OPEN files on, the B 90 further information about the state is given as follows: 
MYUSE (input, output or both) 

OTHERUSE (free, shared, lockaccess or lock) 

ORGANIZATION (sequential or indexed) 

ACCESS (sequential or random) 


— On B 1000 systems, this information is given for OPEN files in the File Paramercr Block 
under the adverb for OPEN. 


5. Work area 
If a work area exists, the following information is provided: 
— the number of the data segment assigned to the work area 
~— the offset into that segment of the work area base 
— the length of the work area (B 90 systems only) 


6. Records per buffer 
This is the number of records contained in a buffer or block. 


7. Record size 
This is the size of records in bytes. 


8. Block size 
The size of the buffer or block in bytes. 


9. Buffer pointer (B 90 systems only) 
This holds an offset into the current buffer to the next available record or, for stream access 
mode, to the next available byte. 

10. Device kind 
As defined in the CMS MCP Reference Manual (form number 2007555). 
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— 
1) 


14. 


15. 


i1. Adverb for close (B 1000 systems only) 


This gives the close attribute type. 


. Adverb for open (B 1000 systems only) 


This gives the open attributes of the file. 


[an 


This gives the FPB flags description 
For example, MUSTBACKUP. 


File type (B 1000 systems only) 
This gives the CMS file type, for example 
DATA, KEYFILE, PRINTERBACKUP 


Number of buffers (B 1000 systems only) 
This gives the number of buffers requested for this file. 


Analysis of disk files provides the following extra information: 


16. 


ny 
~I 


18. 


19. 


20. 


21. 


Sectors per buffer (B 90 systems only) 
This is the number of sectors contained in each buffer. 


RA neriemiiem + a ry 
. Maximum record written (B 90 systems) 


Highest record number (B 1000 systems) 
This is the actual number of records in the file. 


Maximum record declared (B 90 systems only) 
Maximum file size (B 1000 systems) 
This is the maximum number of records the file can contain. 


Disk address details (B 90 systems only) 
Unit and sector numbers (absolute sector address). 


Area number log being processed (B 90 systems only) 

A disk file can have a single area, or be spread over a maximum of 16 areas. 

This number relates to the entry in the disk file header for the particular disk area in use 
when the dump was taken. 


For stream access files (B 90 systems only) 

— spare bytes in the last record: 
If the last record of this file was not completely filled, the number of these spare bytes 
is given. 

— record number at start of current buffer: 


For other types of access 


— current record number 
This is the logical record number at the start of the current buffer. 


22. External file identification (B 1000 systems only) 
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this gives the filename on disk as diskname/file-name 
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Finally, a dump of all the file buffers which exist can be examined or printed. The current buffer is 
dumped first and then the remainder in sequence up to the last buffer. 


Data Segment and Unformatted Dump 


These sections appear in the analysis listing after the language dependent section, but are themselves 
language independent. 


The data segments are printed as hex dumps of each segment. If a particular data segment is an FPE: 
or FIB, it is noted as such in the analysis. 


The unformatted dump is a listing of the locked slice of the task. 


For B 90 systems the locked slice contains: 
Task Control Block (TCB) 
Interpreter work area 
Control stack 
Data segment table 
Task FIBs 
All locked segments 


For B 1000 systems the locked slice contains: 
Program segment table 
Data segment table 
Task control block preset area 
Task control block extension 
Control stack 
Code control block (COP table in COBOL/RPG) 
Internal file-name block 


The following paragraphs describe those parts of a COBOL program dump that relate specifically to 
the COBOL s-language, RPG s-language and MPL s-language. 


COBOL Dependent Dump Analysis 


This section describes those parts of a COBOL program dump that relate specifically to the COBOL- 
S language. 


Dump-Related Dollar Options 


To obtain full information from a COBOL dump, it is necessary to set certain of the dollar options 
at compile time. These are: 


LIST 


Gives a listing of source and corresponding line number, identifies a COP number for each data-name 
and prints the COP table. 


CODE 


Lists Standard COBOL-S 
OPTCODE 


Lists COBOL-S and other code file information. 
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COP-TABLE 


Lists the COP-TABLE transformation, the PPB and the segment table numbers in COBSVERTSR. 
LINE-MAP 


Provides a mapping between object code addresses and source line numbers. 

LINE-CODE 

The compiler generates code to update the COBOL-S LINE-NUMBER register. 

DUMP disk-name/file-name 

Causes the compiler to generate a workfile. This file is processed by COBSVERTER io produce a 
name-file which DUMPANALYSE uses to output, in place of the COP-TABLE listing, a listing of 
the source-names and their current values at the time the program goes DS/DP. To use this name file 
with DUMPANALYSE, include the $NAMEDP option in the initiating message of DUMPANALYSE. 


More information about this name-file is included at the end of the section on language related dump 
analysis. 


For a complete description of these dollar options, refer to the CMS COBOL Reference Manual 
Relative to Release 3.05 form number 2033007). 


To locate the line number on which the dump occurred, it is necessary to set either the LINE-MAP 
or LINE-CODE dollar options when the program is compiled. When LINE-CODE is set, the line-num- 
ber is indicated in the LINE-COUNT area of the Interpreter Work Area. LINE-MAP causes COBS- 
VERTER to list the mapping of code addresses to line-numbers. When a dump is produced the line- 
number of the failure point can be deduced from the Current Code Segment Pointer. 


To obtain information about the contents of data-names, it is useful to set the doilar options LIST 
CODE and OPTCODE (or COP-TABLE). By setting CODE and LIST it is possible to identify the 
STANDARD COBOL-S code generated for a particular statement. COBSVERTER now changes the 
significance of COP-TABLE numbers: some COP-entries are removed from the STANDARD COBOL- 
S COP-TABLE and replaced by in-line code; most COP-TABLE entries are re-ordered. The mapping 
of STANDARD COBOL-S COP-TABLE entries to the COP numbers found in the dump file is printed 
by setting the options OPTCODE or COP-TABLE. To find the values contained in data items which 
do not appear as COP entries, the appropriate segment/displacement must be located. COP-TABLE 
entries can be replaced by actual source data names by: 

— compiling the program with the dollar option DUMP in the program source 

— and using the related name file in the initiating message of the DUMPANALYSE, or specifying 

the namefile on the screen prompt. 


COBOL Segment Allocation 


Data Segments 


Segments 0 and 1 and the last segment are used as run-time compiler work segments. For each file 
declared, an FPB segment, FIB segment and file buffer segment must be allocated (except that the file 
buffer is not necessary for console files). The specification of SAME RECORD AREA allocates a com- 
mon buffer segment. WORKING-STORAGE data items are allocated segments depending on the dollar 
option DSSIZE (or default). 


Code Segments 


Code segments are allocated sequentially by the compiler. 
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If segment numbers in section headers are not used, all code will go in segment 0. If segment numbers 
appear in section headers, each time a new number is encountered, it is assigned a new code segment. 
For modular compilations, segment numbers in the source are local to the module. When bound, each 
module’s segment numbers are mapped to consecutive code segment numbers in the order that the 
modules are bound. 


COBOL S-Interpreter Work Area 


This contains information about: 


the version of the interpreter used 

current address where the program was dumped 

the last communicate message issued by the program 

the state of the Overflow Register and the Line Count Register 
the contents of the table of characters used for editing 

the reason for the dump 

the last Communicate response 

the error number. 


Control Stack 


This contains information about the PERFORMS and/or subroutine calls that were current at the time 
the dump was taken. 


K is the value issued by the COBOL compiler to a particular PERFORM statement. 

SEGNO is the segment number of the calling code segment. 

DISPL is the displacement in that code segment of the call or PERFORM. 

LINE COUNT is the contents of the line count register at the time of the call or PERFORM. 
COP Table (Current Operand Table) 


This is-a table of descriptors of data used by the program. Note that some descriptors are in-line within 
the code segments. 


The descriptor is printed symbolically and, for descriptors which are not subscripted or indexed, the 
contents of the field are listed in hexadecimal. 


Most of the listing is self explanatory; however, the meaning of the data type codes is as follows: 


“UNS8 -— Unsigned 8-bit alphanumeric 

UNS4 — Unsigned 4-bit Binary coded decimal 

SGN8L — Signed 8-bit numeric overpunched leading sign 
SGN8R — Signed 8-bit numeric overpunched trailing sign 
SGN4L — Signed 4-bit BCD numeric leading sign 
SGN4R — Signed 4-bit BCD numeric trailing sign 


These data type codes can also contain an indication of whether the field uses an alternate alphabet. 
For example: 


UNS8 — Unsigned 8-bit 
UNS8E — Unsigned 8-bit with reverse escapement 
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UNS8A — Unsigned 8-bit with alternate graphics 
UNS8EA — Unsigned 8-bit with reverse escapement and alternate graphics 


Namefile Table 


This is a table of descriptors of data used by the program. It gives the same information about the 
descriptors as the COP Table, except that the actual field names used in the program are given instead 
f LOND nnumbhere 


Or CUr nhumoers. 


Any compiler generated COP Table entries will not, however, appear in this table as they cannot be 
identified by name. 


In the COP table analysis only COP entries which appear in the COP Table can be analyzed. Any 
COPs which have been moved in-line in the S-code by COBSVERTER cannot be analyzed. In the na- 
mefile, however, all user generated descriptors will appear in this table even although they may be 
moved in-line by COBSVERTER. 


RPG Dependent Dump Analysis 


This section describes those parts of an RPG program dump that relate specifically to RPG. The S- 
language is the same as the COBOL-S language. 


The COP table information provided under COBOL Dependent Dump Analysis is also relevant to 
RPG. 


Dump-Related Source Constructs 


The following RPG source constructs and dollar options are available to aid the user in the search 
for the cause of the dump: 


1. The use of XMAP, MAP or PARMAP options of the COBSVERTER phase of the compiler 
produces a mapping of line numbers to segment/address for calculation, input and output lines. 

2. The use of column 15 of the H-specification (DEBUG) generates code to set a line-number reg- 
ister, the contents of which are available in the dump analysis. 

3. To interpret the data in terms of source field names, set the dollar options, NAMES and MAP. 
The field denoted by COP in the NAMES listing is used as the OLD COP in the COP TABLE 
of the MAP listing, and the position and attributes of the actual data can be obtained. 

4. To produce a full commented code listing, use the dollar option XMAP. This produces a code 
listing which includes line number indications, subroutine names and other comments in the 
logic cycle. 

5. Using the dollar option(s) NAMEDP and/or PACKDP in an RPG source causes the generation 
of a namefile. This namefile is used by DUMPANALYSE to replace COP TABLE references 
with actual source declared data names. NOTE : not all data names are placed into a COP 
TABLE. To use the name-file with DUMPANALYSE, include the dollar option $NAMEDP 
in the initiating message of DUMPANALYSE, or, on the screen, enter the namefile when 
prompted. 


For more detailed information on these dollar options, refer to the CMS RPG Language Reference 
Manual Relative to Release 3.05 (form number 2033130). 


Object Program Organization 


The following points should be noted about RPG object program organization: 
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1. For each file (except data communications and console files) three data segments are allocated, 
numbered in the range 1 to as many as needed. These are used as the file buffer, FPB and 
FIB. For data comm, there are only two segments; the file buffer, and the CD areas. For con- 
sole files, the FPB is segment 2, the FIB is segment 3, and the file buffers are allocated 
separately. 

2. Literals are generally allocated to read-only segments. 

3. Data segment zero contains edit strings and routine system work-fields. 

Further Information 


For additional information common to COBOL, RPG and the interpreter, refer to ‘““ANALYSIS COM- 
MON TO ALL LANGUAGES?” earlier in this section. Refer also to the CMS COBOL Language Ref- 
erence Manual Relative to Release 3.05 (form number 2033007) CMS RPG Language Reference Manual 
Relative to Release 3.05 (form number 2033130). Interpreter information is to be found in the CMS 
MCP Reference Manual (form number 2007555). 


MPL Dependent Dump Analysis 

These paragraphs describe those parts of an MPL program that relate specifically to the BIL S-lan- 
guage. The CMS compilers (written in either BIL or MPLII) also produce dumps which can be 
analyzed with the aid of these paragraphs. 


MPL. S-Registers 


Refer to the CMS MCP Reference Manual (form number 2007555) for a description of the MPL S- 
language. The S-registers at the time of the dump are analyzed in the program dump, as follows: 


1, PSN 
Program Segment Number; contains the number of the current code segment. 
2. SPN 


Segment Procedure Number; contains the number of the procedure within the segment PSN, 
that was executing at task termination. 


3. PCA 
Program Current Address; holds an offset into the segment PSN of the current S-instruction. 
4. Offset Within Procedure 


This is the offset of the current S-instruction relative to the start of the code of procedure 
number SPN. 


5. NLD 


Number of Local Descriptors; contains the number of occurrences of descriptors declared lo- 
cal to the currently active procedure. 


6. VSN 


Virtual Segment Number; one or more virtual segments can exist whose pages map onto a 
set of data segments with VSN holding the segment number corresponding to the first page 
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11. 


12. 
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of the first virtual memory segment. Virtual segments may be declared in MPL by the SEG- 
MAP construct in which a set of segments can be referenced as one segment (see the CMS 
MPLII Language Reference Manual, form number 2007563). 


MODE 
This register reflects the state of the operation of the S-machine. It can be in one of three 
possible states: 
— PROCESS, DATA.DECL or REMAP.DECL 
If the state of operation is either DATA.DECL or REMAP.DECL then the following registers 
are analyzed. 
— SEGN : holds the data segment number of the data which is being declared or remapped. 
— SOL : holds the offset into SEGN of the start of the area allocated to the previously de- 
clared descriptor. 
— EOL : holds the offset into data segment zero (the data stack), for the location of the 
next descriptor, 
STA 
This register holds an offset into data segment zero for the next available byte on the data 
stack. This is used as a pointer to administer the allocation of space on the data stack. 

. FETCH VALUE 


This is a 24-bit register which holds the result of the previous MCP communicate (the FCM). 


. COMMUNICATE PARAMETER AREA 


This is the last external communicate sent by the interpreter to logical Input/Output on behalf 
of the user’s program. The communicate consists of three parts -— VERB, OBJECT and AD- 
VERB. The fetch value described above reflects the success or failure in the communicate. 


. PARTIAL STACK LENGTH 


This gives the length in bytes of the control stack (this information can also be found in the 
PPB). 


DISPLAY 


The vector DISP is printed. There are two columns: one indicating the lexical level; the other 
the values of DISP containing a pointer to the data stack. 

At most, 16 regions or areas of descriptors are accessible to a task during execution. DISP 
contains offsets into data segment zero to the bases of the procedure parameter descriptors 
and the locally declared descriptors for each of the active procedures which are currently in 
scope. The LVL register indicates the current lexical level of the S-machine. 


REGION 1 AND REGION 2 
These reflect the most frequently used lexical levels in the procedure which was active at the 


time of abnormal termination. This information is useful only when the code segment has to 
be decoded. 
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13. LEVEL 
This gives the current lexical level at which the next instruction resides. 
14. CARRY 


This reflects the value of the CARRY 16-bit field used by the MPL compiler in arithmetic 
operations. 


Formatted Code and Data Stack 
This is an analysis of each of the active procedures at the time of task termination. 
Volatile Registers 


During the dynamic invocation of a procedure, all the volatile registers: PSN, SPN, PCA, LVL, NLD, 
REGI1, REG2, and also the DISP (of the new value of LVL), are saved on the control stack. The 
functions of all these registers have already been explained. The functions of the registers REG1 and 
REG2 are similar to those of register LVL, except that they indicate the lexical level of the “most 


referenced level”? and the ‘“‘next most referenced level’, respectively. 
Descriptor Analysis 
For each descriptor, the following information is printed: 
1. Descriptor address : 
The offset within data segment zero of the base of the descriptor. 


2. Descriptor : 
A hexadecimal representation of the descriptor. 
3. Occurrence Number : 


The descriptor occurrence number as encountered on the pass 3 listing, as determined by the 
order of declarations in the source program. 


4. Data Type : 
The decoded type of descriptor. 

5. Seg/Origin : 
The data segment number in which the actual data resides and the offset of the base of the 
data from the segment base. The value of the @3F@ for the segment number applies to self- 
relative descriptors. 

6. Data : 
A hexadecimal dump of the data. In the case of fixed or self-relative data type, this is the 
hexadecimal value and the converted decimal value (plus ASCII representation or blank). If 


the segment number or the value of the offset within a segment is too large for the segment, 
an error message is printed. 
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Relation to MPL Compilation Listings 


During the compilation of an MPL program, various listings can be obtained, namely the source state- 
ment listing, the XMAP listing and the Procedure Correspondence listing. 


1. Pass ONE Listing : 


This listing is of the source ae At the beginning of each record there are three col- 
fi 


— The procedure occurrence number of the record. 

— The nested ievel of the record. 

— The descriptor occurrence number; that is, the number of parameters and local descriptors 
so far encountered within the current procedure. 


2. Pass TWO Listing : 


From pass two of the compiler, two listings can be obtained: 
1) XMAP 


This contains the occurrence number of the procedure, the procedure name, the code segment 
number and the procedure number within this code segment (that is, PSN/SPN). For each 


aAnnadi: +h rat hk £ 
procedure, the sequence number of each source statement is printed. The offset of the code 


generated by this source statement from the base of the procedure, is printed in parenthesis 
at the left of the sequence number. 


2) The Procedure Correspondence Listing 


This lists all procedures, giving the procedure occurrence number, the procedure name, the 
code segment number of the procedure’s S-instructions, the number of the procedure within 
that segment (that is, PSN/SPN) and the length in bytes of the S-Code generated by the pro- 
cedure statement. 


Location of Program Failure Point 


1. Using PSN/SPN Registers: 


The values of these registers can be used with either the XMAP listing or the Procedure Cor- 
respondence Listing to determine the name of the procedure and its location on the pass three 
listing. 


2. Using PCA Register: 
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From this register value, the offset of the current S-instruction relative to the base of the pro- 
cedure code can be calculated. 

At the base of each code segment there is a procedure table with one two-byte entry for each 
procedure. 

If the number of bytes in this table is added to the number of bytes taken up by the preceding 
procedures in the code segment (obtained from the Procedure Correspondence listing), and 
the result is subtracted from the value in the PCA, then the offset of the current S-instruction 
from the base of the procedure code is the final result. 

This offset can be used to locate the source listing line with the aid of the XMAP listing. 
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Description of Namefile for Use in Source Related Dump Analysis 


This namefile can be used by DUMPANALYSE to replace the COP-NUMBER entry in the COP-TA- 
BLE listing with the respective data-names used in the related source. (not all names appear in the 
COP-TABLE). 


The namefile produced by the compiler is a sequential file of 60 byte records. It consists of several 
record types as follows: 


1. Control Record 


(Provided in first release) 


Bytes Content 

0 @01@ for CONTROL RECORD 

1 @00@ reserved for implementation level if required 

2 @01@ if the file has been updated by by COBSVERTER 
3-14 The program name as in bytes 1-12 of the PPB 
15-20 Compile date as in bytes 51-61 of the PPB 
21-23 Compile time (HHMMSS) 
24-29 Compiler version and user version 

30 @01@ COBOL 

@02@ RPG 

31-32 Record number of the start of entries for symbolic names 
33-34 Number of records containing entries for symbolic names 
35-39 Reserved for future use and will initially contain binary zeros 


2. Data Item Record (COBOL/RPG) 


Bytes Content 
0 @02@ for Data Item record 
1 Declaration level 1-99 in binary 
2-31 User specified name (this may be blank for compiler specified fields) 
32-33 Line number 
34-45 Record offset of fathers entry from the start of the symbolic entry table. If 
no father this entry will contain @FFFF@ 
36-51 COBOL-S descriptor 
52-53 Cop number. If no cops exist this will contain @FFFF@ 
54-59 Reserved and will contain binary zeros 


3. File Entry (COBOL/RPG) 


Bytes Content 
0 @03@ for a file entry 

1-30 User specified file name 

31 Segment number of FPB 

32-59 Reserved and will contain binary zeros 


Output Messages 


The following messages from the utility may appear on the SPO when running the non-interactive anal- 
ysis. When running the interactive analysis, these and other messages which are self-explanatory may 


appear on the screen to inform the user of an exception condition. 
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Message 


**WARNING** BIL DUMP 
FL, SECOND PARAMETER 
IN INIT.MESS IGNORED 


PACK ID TOO LONG 


FILE ID TOO LONG 


INVALID CHARACTERS IN 
FILE 


IN USE 


NOT FOUND <reason> 


MFID NOT PRESENT 
FILE IN USE, OTHERUSE 
CONFLICTS 

BAD FILE TYPE 

DISK NOT FOUND 
DUPLICATE PACK 

DISK ERROR 

DISK LOCKED 

PARITY ERROR 


INTERP. NOT SUPPORTED 


ATTEMPTING UNEDITED 
DUMP 
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Possible Causes 


This message only appears on 
B 90 when program-name has 
been specified for a dump file 
from an MPL program. 
On B 1000, MPL dumps 


acouma a 


assume a default program- 
name if one is not specified. 
The disk name specified for 
the disk on which the 
namefile is to reside is invalid 
because it contains too many 
characters. 


The file name specified as the 
namefile has been entered with 
too many characters. 


Invalid characters have been 
used in the initiating message 
(for example in a filename). 


A specified file is already in 
use by another program. 


A specified file could not be 
accessed. <reason> is an 
interpretation of the fetch 
value returned to 
DUMPANALYSE specifying 
why the file could not be 
accessed. 


These are reasons for the 
FILE NOT FOUND condition. 


The DP’d file cannot be 
recognized by 
DUMPANALYSE. This is 
probably due to an object file 
not being COBOL object, 
RPG object or MPL object 
but could also be due to a 
corrupt file being used. 


This message is generated 
after ““INTERP. NOT 


Suggested Action 
None. 


Check input and re-enter. 


Check input and re-enter. 


Check input and re-enter. 


None. 


None. 


Check file. 


None. 
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Message 


NO SPECIFICATION GIVEN 


INVALID CODEFILE — 
NOT COMPATIBLE WITH 
DUMPFILE 
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(continued) 
Possible Causes 
SUPPORTED’’. 
DUMPANALYSE will attempt 
to generate an unedited dump. 


Suggested Action 


This is output when the Check input and re-enter. 
initiating message given is 


incomplete. 


This is output when the Check input and re-enter. 
dumpfile supplied is not a 


dump of the program-name. 


ECMA.LD (Load/Dump of ECMA Tape Files — B 90/B 900 
Only) 


This utility allows the operator to structure tape files according to ECMA BASIC and ECMA COM- 
PACT systems as specified in the STANDARD ECMA-41 publication. 


The ECMA tapes are treated as unlabelled tapes in the CMS system. The utility is initiated in two 
different ways for BASIC system and COMPACT system. 


Basic Initiation 


Format (Disk to Tape copy) 


DUMP 
ECMA.LD au 
UNLOAD 


The files are copied from the disk to a purged tape. If the option UNLOAD is specified, the files 
copied are removed from the disk. 


FROM < disk-name > < fiiename > 


Format (Tape to Disk copy) 


ae 


RECORD < number > 


TO <disk-name > 


BLOCK < number > 


ECMA.LD LOAD 


The files are copied from an ECMA BASIC tape to the disk specified by disk-name. The option 
RECORD followed by a number specifies the record size in bytes on the tape and BLOCK followed 
by a number is the blocking factor; that is, number of records per block. 

If the RECORD and BLOCK options are used, the first file on tape is read according to the first attri- 
butes, the second file is read according to the second attribute etc. If the block size (that is, record 
size x number of records per block) exceeds 256, then an error message is issued and loading is not 
performed. 


If RECORD and BLOCK options are not used, tape files are loaded as 256 byte records blocked 1. 
The names of the ECMA tape files loaded to the disk become ECMA001, ECMA002,....ECMA00n. 
Examples: 
To copy files INO01, IN002 from the systems disk to a tape in ECMA BASIC format: 

ECMA.LD DUMP IN001, IN002 
To copy file AR030 from the disk ARDISK to tape and remove after copy: 

ECMA.LD UNLOAD FROM ARDISK AR030 


To copy files PR200, record size 80 block 160, PR120, record size 60 block 180, to the system disk 
from ECMA BASIC tape on device CTA: 
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ECMA.LD LOAD RECORD 80 BLOCK 2, RECORD 60 BLOCK 3 
The utility will display the following message: 
mix no/ECMA.LD <14> WAITING UNLAB ECMATAP/NONE AT DEVICE REQUIRED 
Then enter: 
AD mix number CTA 
The files PR200 and PR210 will be called ECMA001, ECMA002 on the disk. 
Compact Initiation 


Format (Disk to Tape copy) 


DUMP ; 
ECMA.LD {- FROM < disk-id > < file-id > 
UNLOAD 


The files are copied from the disk to tape. If the option UNLOAD is used, files copied are removed 
from the disk. 


Format (Tape to Disk copy) 


ECMA.LD LOAD an TO < disk-id > 


The files are copied from an ECMA COMPACT tape to the disk specified by disk name. If any file 
is already present on the disk, it will be removed before the same named file is copied. The option 
RECORD followed by a number specifies the record size in bytes on the tape and BLOCK followed 
by a number is the number of records in a block. 


RECORD < number > BLOCK < number > 


If RECORD and BLOCK options are used then the first file on the tape is read according to the first 
attribute and the second file is read according to the second attribute. If block size (that is, record 
size x number of records per block) exceeds 256 then an error message is given and utility will termin- 
ate. 


If RECORD and BLOCK options are not used, then tape files are loaded as 256 byte records blocked 
1. 


The ADD option will copy a file to the disk only if that file is not already present. 
Examples: 


To copy files INO01, INO02 from the disk INDISK to a tape FRED in ECMA COMPACT format: 
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ECMA.LD DUMP TO FRED FROM INDISK INO01, IN002 
To copy files INO10 from the system disk to a tape FRED and remove from the disk after copy: 
ECMA.LD UNLOAD TO FRED INO10 


To copy files IN001, IN002 from tape FRED on CTA, which is created in ECMA COMPACT format, 


tn +t i 
to the system disk: 


ECMA.LD LOAD FROM FRED IN001 RECORD 80 BLOCK 2, IN002 


The utility will display the following message: 


Mix number/ECMA.LD <14> WAITING UNLAB ECMATAP/NONE AT DEVICE RE- 


QUIRED 
The response should be: 


AD mix number CTA 
Output Messages 


Message 


NOT A BASIC ECMA 
TAPE 


NOT A COMPACT ECMA 
TAPE 


NO FILES IN THE FAMILY 
<group-name> ON TAPE 
<tape-name> FOR DUMP/ 
LOAD ADD/UNLOAD 


NO FILES IN THE FAMILY 
<family-name> ON DISK 
FOR DUMP/LOAD/ADD/ 
UNLOAD 


NO FILE <file-name> ON 
TAPE <tape-name>/DISK 
<disk-name> FOR LOAD/ 
DUMP/ADD/UNLOAD 


< file-name> REMOVED 


<file-name> LOADED 


< file-name> DUMPED 
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Possible Causes 


Loading is requested from a 
BASIC tape but the tape is 
not a BASIC format. 


Loading is requested from a 
COMPACT tape but the tape 
is not a COMPACT format. 


Specified files are not present 
on the tape. 


The specified group of files is 
not present on disk 


The specified file is not 
present on tape or on disk. 


This message is displayed for 
each file removed by a 
LOAD or UNLOAD. 


This message is displayed for 
each file added or loaded. 


This message is displayed for 
each file dumped or 
unloaded. 


Suggested Action 
Check the tape and re-input. 


Check the tape and re-input. 


Check the group name and/or 
the tape, and re-input. 


Check the group name and re- 
input 


Check the file-name and re- 
input. 


None. 


None. 


None. 


4-121 


-_ UF ee 


Message 


<file-name> NOT LOADED 
— ALREADY ON DISK 


<file-name> NOT FOUND 


fileename HAS BEEN 
REMOVED — DUMP 
ABANDONED — TAPE 
BEING PURGED 


<filenname> HAS BEEN 
ALTERED — DUMP 
ABANDONED — TAPE 
BEING PURGED 


<file-name> IN OUTPUT 
USE — DUMP 
ABANDONED — TAPE 
BEING PURGED 


BLOCK COUNT ERROR 


INCORRECT TAPE NAME 


NOT FIRST PART OF FILE 


DATA BLOCK TOO LARGE 


<file-name> DATA FILE 
NOT FOUND ON TAPE 
FOR LOAD 
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(continued) 
Possible Causes 


Self-explanatory 


The file is not found on disk. 


The specified disk file to be 
copied to tape has been 
removed before the utility was 
able to copy it. 


The contents of the file to be 
copied to tape were altered 
after the start of the dump 
and before the utility was 
able to copy it. 


The file cannot be dumped to 
tape as it is being used as an 
output file. 


This is displayed when the 
BLOCK COUNT entry in the 
end-of-file label, end-of-track 
label, or end-of-volume label 
does not match with the 
actual number of blocks read 
during a LOAD or ADD. 


For a COMPACT format 
tape, the names in the 
initiating message and the 
tape label do not agree. 


A section number other than 
1 was found when reading the 
first label on tape. 


The block size on tape for a 
LOAD or DUMP is greater 
than 256 bytes. 


File specified for COMPACT 
format LOAD cannot be 
found. 


Suggested Action 


Check input and re-enter. 
None. 


None. 


None. 


Possible bad tape: retry with a 
different drive or with a backup 
tape. 


Check the tape label and re- 
input. 


None. 


Check file name and re-input if 
necessary. 


FILEUTL (FILE MAINTENANCE UTILITY) 


FILEUTL runs only under datacomi on a TD 830 type terminal. FILEUTL is interfaced to GEMCOS 
using forms mode and requires a screen size of 80 characters by 24 lines. 


The utility name must be in the TCL and must have its interface set to TCMS. 


<cc> RN FILEUTL 


where <cc> is the control character 


FILEUTL provides the facilities to create a new file and update or remove an existing file. Records 
may be displayed, edited or added to a file. These facilities are restricted to source and data type files 
(#00-#0F). 


A “FIND” command is provided to search for records containing specifiable key values. 
It is possible to copy records from an existing file to the file currently being created or modified. 


To delete records from an existing file, it is necessary to create a new file and then copy only the 
records which are to be maintained from the existing file to the new file. 


All record input and updating is done directly to the actual file. 


All user entry fields except those for disk-names, file-names and record data are numeric or 
hexadecimal — no English key words are used. 


Indexed files are not supported in this release of FILEUTL. 


The file SYS.FILEUTL contains the screen formats and messages for the utility. The filetype of this 
file is #47 and the first record contains a check-string and version number which are checked by the 
utility when the file is opened. 


Screen Formats and Functions 


Screen 1. SELECT function — CREATE new source or data file 
UPDATE existing source or data file 
DISPLAY any existing type of file 
REMOVE existing source or data file 
HELP — program information 
TERMINATE program. 


Entry of attributes and options — CREATE 
Entry of attributes and options — UPDATE 
Screen Entry of attributes and options — DISPLAY 


Screen 2 
3 
4. 
Screen 5. Selection of record sections — CREATE, UPDATE or DISPLAY 
6 
7 
8 


Screen 


Record input or edit -— CREATE or UPDATE 
Record copy or display from another file — CREATE or UPDATE 
Record Display — DISPLAY 


Screen 
Screen 
Screen 
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9. Specify keys 
10. Find record information — CREATE, UPDATE or DISPLAY 
11/12/13. Program information — HELP 


After utility has been successfully attached to a station, screen 1 is displayed. 


The user is requested to enter an option number and/or parameters in entry fields on each screen dis- 
play. When valid input has been entered and transmitted, the next logical screen is displayed — see 
routing diagram, figure 4-4. 


Key to Screen Formats 


fffffffeffft File identifier 

ddddddd Disk identifier 

SSSSSSS System disk identifier 

IIT Record size 

bbbbb Block size 

nannnnn Actual no. of records in file 
mmmmmmm Maximum possible no. of records in file 
XXXXXXX Current record no. 

VYVVVVV Current record no. + | 

ZZZZZZZ Actual no. of records in file + 1 
aaaaaaaa Data from record (ASCII) 
hhhhhhhh Data from record (hexadecimal) 


COECECECE EEE KE KC ECC EEE 


Display line reserved for error message 


date.and.time Example — FRI 14 AUG 81 AT 11.04.56.4 


These fields are protected and cannot be over-written unless enclosed in unprotected field delimiters 
> OS. 


> < Unprotected data entry field delimiters. 
> 180< Unprotected Data Entry Field Delimiters with default. 
Screen top and bottom. 


Cursor Management 


If a screen is transmitted with the cursor sitting in the first character position of the first unprotected 
entry field, the data in all unprotected entry fields as displayed is saved by the program. 


If a screen is transmitted with the cursor not sitting in the first character position of the first unpro- 
tected entry: 


1. The data, as displayed in any unprotected data fields preceding the field where the cursor is 
currently situated, is saved. 


2. If the cursor is in the first character position of an entry field, the data in this field as originally 


displayed is saved. If not, the contents of the field up to the cursor are saved and the rest of 
that field is assumed to be blank filled. 
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START 


1 
SELECT 


3. 
CREATE UPDATE 


4. 
DISPLAY 


T/EDIT 2 DISPLAY 
RECORD | 


DISPLAY/COPY RECORDS 
FROM ANOTHER FILE 


ROUTING DIAGRAM for FILEUTL 


S.R.S. — Select Record Sections 
S.F.K.— Specify FIND keys 


(REMOVE and HELP functions are 
not included in this diagram) 


Figure 4-4. Routing Diagram for FILEUTL 
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SSS 


3. The data as originally displayed in any following fields is saved — any modifications done to 
these fields are not saved. 
NOTE 
Record Data Entry fields in the RECORD INPUT/EDIT screen are handled 
differently as explained in under Screen 6. 


When a screen is displayed, the cursor is positioned at the start of the most convenient entry field 
for ease of use on that particular screen. 


When invalid data is entered and transmitted, the same screen is re-displayed and the first entry field 
with invalid data is highlighted with the cursor positioned at the start of that field. A message identify- 
ing the error is also displayed on the bottom line of the screen. 
NOTE 
The screen may be refreshed by pressing the ‘“HOME”’ key, entering ‘‘0’’ 
and transmitting. For further details, see Screen 13 — HELP 3. 
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Screen 1 — Select 


oe pe a 


CMS UTILITY - FILEUTL | VERSION 3.04.01 date.and.time 


ENTER "1" TO CREATE A NEW FILE 
OR "2" TO UPDATE AN EXISTING FILE 
OR "3" TO DISPLAY AN EXISTING FILE 
OR "4" TO REMOVE AN EXISTING FILE 
OR "5" IF HELP IS REQUIRED 
OR "6" TO FINISH THIS PROGRAM RUN >1< 


IF "5" OR "6" IS ENTERED, ALL OTHER INPUT FROM THIS SCREEN WILL BE 


IGNORED. 
IF CREATING A NEW FILE, SELECT THE TYPE REQUIRED. 
ENTER "1" FOR SOURCE - INPUT IN ASCII 
OR "2" FOR DATA - INPUT IN ASCTI 
OR "3" FOR DATA - INPUT IN HEXADECIMAL >1< 
ENTER FILE IDENTIFIER > < 
ENTER NAME OF DISK ON WHICH FILE RESTDES OR WILL RESIDE >Sssssss< 


eee See tee a ee ee SS ee 


If function 1, 2, 3 or 4 is selected, a file identifier must also be entered. 
The duplicate file condition is checked for at this stage in the CREATE function. 


’ The maximum record size which can be supported by the utility is 2000 bytes in either hexadecimal 
or ASCII Input/Display mode. The record size of the entered file-name is checked to be within these 
limits in the UPDATE and DISPLAY functions. 


If function 4 is selected, the utility attempts to remove the entered file-name. Only files with filetypes 
of #00 — @OF (data or source) and record size less than or equal to 2000 may be removed. This screen 
is re-displayed with a message to report whether the request was successful or not. 


If function 5 is selected, three screens of useful information on this utility are displayed before screen 
1 is re-displayed (see screens 11, 12 and 13). 


For this screen and all other screens, if invalid input is entered and transmitted or any error condition 


(for example, duplicate file or record size too large) is detected, the same screen is re-displayed with 
a message in the bottom line identifying the error. The user should then attempt to re-enter valid input. 
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Screen 2 — Create 


a ee 


FILE IDENTIFIER 


NAME OF DISK ON WHICH FILE WILL RESIDE 
CREATION DATE OF FILE WILL BE 


FILE TYPE/INPUT MODE 


fFFFT TTF ttt 
ddddddd 

FRI 14 AUG 81 

<00> DATA/HEXADECIMAL 


ENTER RECORD SIZE OF FILE >180 < 


ENTER BLOCK SIZE OF FILE >180 < 
ENTER MAXIMUM NO. OF RECORDS FILE WILL CONTAIN >2048 < 


ENTER RECORD FILLER - ONE CHARACTER FOR ASCII 
- TWO CHARACTERS FOR HEX, >00< 


ENTER "1" TO COMMENCE RECORD INPUT 


OR "2" TO SELECT RECORD SECTIONS 
OR "3" TO RETURN TO FUNCTION SELECTION >1< 


IF "3" IS ENTERED THIS FILE WILL NOT BE CREATED, 


——-—_— eee 


Entering a zero in the first column of ‘‘RECORD SIZE OF FILE’ causes the screen to refresh (see 
Screen 13 — HELP 3). 


This example is for a data file using hexadecimal input mode. 
The maximum record size permitted for a source or data file is 2000 bytes. 
Defaults for source file: 


The “CENTER RECORD FILL CHARACTER”’ option entry field is protected and contains a 
blank character. 


Record size entry field — 80 (bytes) 
Block size entry field — 720 (bytes) 


“FILE TYPE/INPUT MODE” display is ‘“<01> SOURCE/ASCII”’. 
Defaults for data file with ASCII input: 


The “ENTER RECORD FILL CHARACTER” entry field is one byte long with ‘‘0’’ default en- 
tered. 


“FILE TYPE/INPUT MODE”? display is ‘““<00> DATA/ASCII”. 
When valid file attributes have been entered and transmitted, the utility opens the new file and closes 


it as soon as it is full. This may allow recovery of a new file in the event of a system failure while 
the file is being created. 
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Screen 3 — Update 


A 


FILE IDENTIFIER CCPL TE TT © 

NAME OF DISK ON WHICH FILE RESIDES ddddddd 

CREATION DATE/LAST ACCESS DATE OF FILE 11 JUL 81/14 AUG 81 
RECORD SIZE/BLOCK SIZE OF FILE rrr/bbbbb 

NO. OF RECORDS IN FILE nonnnnnn 

MAXIMUM NO. OF RECORDS FILE CAN CONTAIN mnmmmmm 

PULE TYPE <00> DATA 


ENTER "1" TO COMMENCE RECORD DISPLAY 
OR "2" TO SELECT RECORD SECTIONS 
OR "3" TO RETURN TO FUNCTION SELECTION >1< 


ENTER "1" FOR ASCII INPUT MODE 
OR "2" FOR HEXADECIMAL INPUT MODE >< 


ENTER RECORD FILLER - ONE CHARACTER FOR ASCII 
TWO CHARACTERS FOR HEX. >0 < 


The “ENTER INPUT MODE” and ‘‘“ENTER RECORD FILL CHARACTER” option entry fields are 
protected for source files. 


The “FILE TYPE” display is ‘‘<01> SOURCE”’ for source files. 


As new records are added to a file being created in the CREATE or MODIFY functions, the utility 
half closes and re-opens the file after every nth new record entered, where n is the smallest of the 
three values: 


1. 1000/record size (if 0 then 1) 
2. ( (10/block factor) x block factor) (if 0 then 1) 
3. 10 


This invokes an update of the ‘‘actual number of records in file/End of File pointer’’ field in the Disk 
File Header. 


In the event of a system failure while a file is being created or modified, no more than the last n 


new records (1000 bytes of record information or 10 records maximum) entered should be lost, pro- 
vided no directory or file corruptions have occurred. 
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Screen 4 — Display 


a i eh 


FILE IDENTIFIER FRTTECP EP FCT 

NAME OF DISK ON WHICH FILE RESIDES ddddddd 

CREATION DATE/LAST ACCESS DATE OF FILE 17 JUL 81/11 JUL. 81 
RECORD SIZE/BLOCK SIZE OF FILE rrrr/bbbbb 

NO. OF RECORDS IN FILE nnnnnnn 

MAXIMUM NO. OF RECORDS FILE CAN CONTAIN mmmmmmm 

FILE TYPE <10> CODE 


ENTER "1" TO COMMENCE RECORD DISPLAY 
OR "2" TO SELECT RECORD SECTIONS 


OR "3" TO RETURN TO FUNCTION SELECTION >1< 
ENTER "1" FOR ASCII DISPLAY MODE 
OR "2" FOR HEXADECIMAL DISPLAY MODE >1< 


a a ec a a 
This example is for a code type file. 


Any type of file may be selected for display in either ASCII or hexadecimal mode. 
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Screen 5. — Select Record Sections 
Oo nee ea es age ee ee ae 


ENTER "1" TO SELECT RECORD SECTIONS 
OR "2" TO DISPLAY COMPLETE RECORD >1< 


IF "1" IS NOT ENTERED, ALL OTHER INPUT FROM THIS SCREEN WILL BE IGNORED. 


UP TO 12 SECTIONS OF A RECORD MAY BE SELECTED FOR DISPLAY SECTION 
ON A SINGLE SCREEN BY ENTERING IN ORDER, THE START POSITION START 
OF EACH SECTION IN THE TABLE ON THE RIGHT. THE LAST POSITION POSITION 
MUST BE LESS THAN OR EQUAL TO THE RECORD SIZE OF THE FILE 
: > < 
WHICH IS xXXXXe S e 
A RECORD SECTION CONSISTS OF ALL THE CHARACTERS IN A RECORD > < 
BETWEEN THE ENTERED START POSITION AND THE NEXT SECTION > < 
START POSITION OR THE END OF THE RECORD . IF THIS NUMBER OF > < 
CHARACTERS EXCEEDS yy; THEN ONLY yy CHARACTERS WILL BE > < 
DISPLAYED. > < 
. > < 
IN RECORD INPUT/EDIT SCREENS, THESE SELECTED SECTIONS MAY BE > < 
INPUT OR EDITED AS IF THE COMPLETE RECORD WAS DISPLAYED. IF > < 
THE CURRENT RECORD IS NEW, ALL OTHER SECTIONS WILL BE FILLED 7 < 
WITH THE APPROPRIATE FILL CHARACTER OTHERWISE THEY WILL > < 
REMAIN UNALTERED. > < 


: 
yy — 25 for Hexadecimal character input 
50 for ASCII character input 


This option, which may be selected from the Record Input/Edit, Record Copy or Record Display func- 
tion, allows the user to select up to 13 specific sections of a record to be displayed on one screen and 
is self explanatory. Complete Record display is described in the next section. 


If invalid start positions are entered, this screen is re-displayed with a message identifying the error. 


If creation or modification of a file (file-a) is completed and a new file is created or an existing file 
is selected for modification or display (file-b); provided the input type and record sizes of file-a and 
file-b are the same, record sections for file-b default to those last set for file-a if the select record sec- 
tion screen is not requested. Otherwise, the complete record display mode is the default. 
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Screen 6 — Record Input/Edit 


a i gg eh 
FILE ffffffffftff MAX. POSSIBLE SIZE OF FILE IS mmmmmmm RECORDS 
DISK ddddddd ACTUAL SIZE OF FILE IS nnnnnnn RECORDS 


ENTER "1" TO INPUT,EDIT OR DISPLAY CURRENT RECORD 
OR "2" TO COPY RECORDS FROM ANOTHER FILE 
OR "3" TO RE-SELECT RECORD SECTIONS 
OR "4" IF WORK ON THIS FILE IS COMPLETED >1< 
OR "5" TO SPECIFY KEYS FOR FIND COMMAND 
IF "1" IS NOT ENTERED, ALL OTHER INPUT FROM THIS SCREEN WILL BE IGNORED. 


CURRENT RECORD NUMBER IS xxxxxxx >rec.check< 
] >00000000000000000000000000000000000000000000000000< 

33 >00000000000000000000000000000000000000000000000000< 
63 >0000000000000000< 
7] 700000000000000000000000000000000000000000000000000< 
103 >0000000000000000< 

111 >0000000000000000< 

119 +=>Oo000K< 

121 >oood0K< 

123 >000000< 

126 >00000000< 

130 ©>0000000000< 

135 >000000000000000000000000000000< 


ENTER NEXT RECORD TO BE DISPLAYED OR "FIND" syyyyyyy< 


The >rec.check< field is protected. When this screen is transmitted back to the program, the content 
of the field is verified as unchanged. If not, the screen for the current record or part(s) of this record 
displays the message, “INVALID INFORMATION RECEIVED — PLEASE RE-ENTER”’. 


Since record sizes up to 2000 bytes are permitted and it is impossible to display a complete record on 
a single screen format, it may be necessary for the utility to display a record on more than one succes- 
sive screen, but on as few as possible, depending on the input type (ASCII or Hex.) and record size. 
This is required for all options of the utility which display record information — Record Input/Edit, 
Record Display and Record Copy. 


For ASCII input, a maximum of 500 bytes is displayed per screen, 50 bytes by 10 lines; up to four 
screens may be necessary to display a complete record. 


For Hex. Input, a maximum of 250 bytes is displayed per screen, 25 bytes by 10 lines; up to eight 
screens may be necessary to display a complete record. 


These display formats of 500 bytes/ASCII and 250 bytes/Hexadecimal per screen are fixed. 


When more than one screen is required to display a record, the ‘‘NEXT RECORD TO BE DIS- 
PLAYED” field contains the record number of the current record in all screens except the last, where 
it is incremented to the current record number + 1. 


The user may select another option or alter the above field before all the screens of the current record 
have been displayed. If a new record is being displayed for input by the Record input/Edit option, 
those parts of the record described by screens which were not displayed are filled with appropriate fill 
characters. For an old record, the un-displaved/un-edited parts of the record remain unaltered. 
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TOO 


This method of displaying a complete record is the same for screens 7 and 8, Record Copy and Record 
Display. 


If the current record number is the next new record, the record entry field(s) are filled with the pre- 
defined or default fill character. 


If an already written record is selected, that record is displayed in the record entry field(s) and may 
be edited as required. 


A “NEXT RECORD TO BE DISPLAYED” field entry which is greater than the current size of the 
file + 1 is invalid. 


“FIND”? may be entered if keys have been specified for the find command. If requested, the utility 
will search from the current record + i. if a record is found containing the specified keys, that record 
will be displayed, if not, the previous current record will be re-displayed. 


Cursor management: If this screen is transmitted with the cursor sitting in a record data entry field, 
all the data up to the cursor is saved. Any modifications done after the cursor in entry fields following 
the cursor (including the field the cursor is sitting in) are not saved; the data as originally displayed 
is saved. 


The example for screen six shows record entry fields for a data file with record sections selected at 
1, 33, 63, 71, 103, 111, 119, 121, 123, 126, 130, 135 and 140; record size is 150, input mode is hexadec- 
imal, Hex. 00 is the fill character and the screen is waiting for information for new record number 
XXXXXXXX to be entered. 
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gn a ee ee 
Screen 7 — Copy Records From Another File 


a a as te ht ol ee 
ENTER "1" TO DISPLAY OR COPY RECORDS 


OR "2" TO RE-SELECT RECORD SECTIONS >1< 

OR "3" IF NO OTHER FILES ARE REQUIRED 
ENTER IDENTIFIER OF FILE CONTAINING THE REQUIRED RECORDS > < 
ENTER NAME OF DISK ON WHICH THIS FILE RESIDES >sssssss< 
ENTER REQUIRED RECORD NUMBER, LAST IN FILE IS | [J] 4] [ >) < 

] aaaaaaaaaaaaaaaaaaaa< 

21 aaaaaaaaaa< 

31 aaaaaaaaaaaaaaaaaaaaaaaaa< 

56 aaaaaaaaaaaaaaaaaaaaaaaaac< 

8] aaaaaaaaaaaaaaaaaac 

99 aa< 
TO COPY THIS REC, OR RANGE FROM THIS REC, ENTER END REC. NO > < 
FILE ffffffffffTT MAX. POSSIBLE SIZE IS ttttttt RECORDS 
DISK ddddddd SIZE OF FILE NOW IS ttttttt RECORDS 
ENTER STARTING NUMBER FOR THESE RECORD<S> TO BE COPIED TO > < 


Sa emnremmneemannn meee ee 


In this example, record sections selected at 1, 21, 31, 56, 81 and 99 are for a source file or data file 
in ASCII mode with a record size of 100 bytes. 


The secondary file (from which records are displayed or copied) must be of the same type and have 
the same Record Size as the primary file (being created or updated). 


Record sections are the same as for the primary file. 


The ‘‘End of Range record”’ entry field and the ‘‘Starting record in the primary file’’ entry field are 
always blank by default. This allows records in the secondary file to be listed without any record copy- 
ing being performed. 


To copy records, the user must enter valid record numbers in both the above fields. 


NOTE 
To copy only one record, the same record number as that requested for dis- 
play must be entered in the ‘‘End of Range record’’ field. 


Secondary File record display fields are write protected in this screen. 
Until a valid file-name has been entered and transmitted to the program and that file has been success- 
fully opened, no record information is displayed. Also, the “‘LAST IN FILE IS” display, which refers 


to the last record in the Selected Secondary file, has ‘‘....... ** in the record number field until that 
file has been successfully opened. 
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Screen 8 — Record Display 


fFTfTfffrfff “MAX. POSSIBLE SIZE OF FILE IS mmmmmmm RECORDS 
ddddd ACTUAL SIZE OF FILE IS nnnnnnn RECORDS 


ENTER "1" TO DISPLAY RECORD 
OR "2" TO RE-SELECT RECORD SECTIONS 
OR "3" IF NO MORE RECORDS ARE TO BE DISPLAYED >i< 
OR "4" TO SPECIFY KEYS FOR THE FIND COMMAND 
IF "1" IS NOT ENTERED, NEXT RECORD NUMBER WILL BE IGNORED. 


21 >hhhhhhhhhh< 
26 >hh< 

27 >hhhhhhhhhh< 
32  >hh< 

33. >hhhhhhhhhh< 
38 >hhhhhh< 

4] >hh< 

42  >hh< 

43 >hh< 

44 >hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh< 
60 >hh< 


ENTER NEXT NUMBER TO BE DISPLAYED OR "FIND" >yyyyyyy< 


tL 


In this example, record sections have been selected for a file with a record size of 80 and the display 
mode is in hexadecimal. 


Record information display fields are write protected in this screen. 


Any type of file is permitted in the display function including “SYSMEM’’. 
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a ag a See OS 
Screen 9 — Specify Keys 
a BO et Se ee Nl? 
ENTER "1" TO SPECIFY KEYS FOR FIND COMMAND 

OR "2" TO SET FIND COMMAND FOR X-FILLED RECORDS >dJ1< 


OR "3" IF FIND COMMAND IS NOT REQUIRED 
IF "2" IS ENTERED, KEY SPECIFICATION ON THIS SCREEN WILL BE IGNORED. 


LENGTH KEY VALUE TEST POS.N 
> < > <> <> < 
> < > <> <> < 
> < > <> <> < 


UP TO THREE KEYS MAY BE SPECIFIED. 

LENGTH < ENTER EXACT LENGTH OF KEY. 

MAXIMUM FOR THIS FILE IS xx IN yyyy MODE. 

KEY VALUE < ENTER VALUE OR STRING TO BE FOUND 

TEST < ENTER “= He aget We i ">=" OR "> 8 

POS.N < ENTER POSITION IN RECORD ONLY IF KEY IS TO 
BE TESTED AT A SPECIFIC LOCATION. 


TE mi AN Fr wunir ERPAONR wettest mer erannicn 


ir BLANK, THE WHOLE RECORD WILL BE SEARCHED. 


A RECORD WILL BE FOUND ONLY IF ALL SPECIFIED KEY TESTS ARE SUCCESSFUL. 
THE FIND COMMAND CAN BE REQUESTED ON THE RECORD DISPLAY SCREENS. 


IF REQUIRED, A SEARCH CAN BE INITIATED NOW ON FILE ffffffffffff 
ON DISK ddddddd BY ENTERING THE STARTING RECORD NUMBER.  >yyyyyyy< 


Specification of keys for the FIND command may be requested from the record input/edit and record 
display screens. 


Key values should be entered in ASCII or Hex. depending on whether the file is being edited or dis- 
played in ASCII or Hex. mode. 


Once keys have been specified, or the FIND command has been set to search for ‘‘X”’ filled records, 
that setting will remain unchanged until a file of different record size is selected, the intput/edit/display 
mode is altered (ASCII/Hex), or the option to specify keys is requested again. 


The maximum length of key value which can be specified is 28 if in hex. mode, 56 if in ASCII mode, 
or the record size of the file, whichever is smaller. This appears at field xx on the screen. ‘‘ASCII” 
or “HEX”? will appear in field yyyyy. 


If the starting record number field is left blank, the utility will re-display the last record displayed. 
The ‘“‘FIND’’ command can be requested from the record input/edit screens when required. 


If a starting record number is entered, the FIND command will commence searching the file from this 
record number (see screen 10). 
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Screen 10 — Find Information 


THE UTILITY IS SEARCHING 


FILE fffffffffttf 
ON DISK ddddddd 


FOR A RECORD CONTAINING THE xxxxx KEY<S> 
LENGTH KEY VALUE TEST POSITION 


or 
FOR A RECORD FILLED WITH "X" ASCII CHARACTERS <HEX. 58> 
(if in Hex. mode) 


or 
FOR A RECORD FILLED WITH "X" ASCII CHARACTERS 
(if in ASCII mode) 


FIND COMMAND MAY BE TERMINATED BY PRESSING XMIT KEY ONCE. 
ey Se eG 


This screen, which is for information only, is displayed when the FIND command has been requested 
from the record input/edit display screens, or initiated from the specify keys screen. 


The command will search from the appropriate record for a record containing the specified keys or 
“*X’? filled records. When the end of file is reached, the command will search from the start of the 
file, but only as far as the record from which the search was initiated. 


If a record is found, that record will be displayed with a message identifying the position of the 
specified keys within the record. 


If the FIND command is terminated or is unsuccessful, the screen from which the command was initi- 
ated will be re-displayed. 


“ASCII” or ‘SHEX’’ will appear in the xxxxx field. 


A message will be displayed on the bottom line of the screen which will inform the user of the progress 
of the search. See paragraphs on Screen Messages. 
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Screen 11 — Help 1 


THIS PROGRAM CAN BE USED TO CREATE, UPDATE AND REMOVE SOURCE OR DATA 
TYPE FILES. ANY TYPE OF FILE CAN BE DISPLAYED. 


THE MAXIMUM RECORD SIZE WHICH CAN BE HANDLED IS 2000 CHARACTERS. 


IN THE CREATE AND UPDATE FUNCTIONS, NEW RECORDS MAY BE INPUT INTO THE 
FILE AND OLD RECORDS MAY BE EDITED USING THE RECORD INPUT/EDIT SCREEN 
BY ENTERING OR ALTERING THE RECORD INFORMATION IN THE RECORD’ ENTRY 
FIELDS. RECORDS MAY BE SELECTED BY ENTERING THE REQUIRED RECORD 
NUMBER IN THE "NEXT RECORD NUMBER TO BE DISPLAYED" FIELD. 


RECORDS MAY BE COPIED FROM ANOTHER FILE BY SELECTING THE COPY OPTION 
FROM THE RECORD INPUT/EDIT SCREEN. RECORDS CAN BE DISPLAYED AND COPIED 
FROM ANY SELECTED FILE WHICH HAS THE SAME RECORD SIZE AND IS OF THE 
SAME TYPE AS THE FILE BEING CREATED OR UPDATED. COPIED RECORDS MAY BE 
ADDED TO THE END OF THE FILE OR MAY OVER-WRITE EXISTING RECORDS. 


TO DELETE RECORDS FROM AN EXISTING FILE, A NEW VERSION OF THE FILE 
MUST BE CREATED USING THE CREATE FUNCTION. THE REQUIRED RECORDS CAN 
THEN BE COPIED TO THE NEW VERSION OF THE FILE USING THE COPY OPTION. 
THE DISPLAY FUNCTION ONLY ALLOWS RECORDS OF A FILE TO BE DISPLAYED. 


PRESS "XMT" TO CONTINUE 
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Screen 12 — Help 2 


rn 


"RECORD FILLER” FIELD = WHEN CREATING OR UPDATING A DATA TYPE FILE, 
THE USER MAY ENTER A CHARACTER WHICH WILL FILL RECORD ENTRY FIELDS IN 
RECORD INPUT/EDIT SCREEN FOR NEW RECORDS. 

IF A SINGLE CHARACTER IS ENTERED WITH A LEADING OR TRAILING BLANK, THAT 
SINGLE ASCII CHARACTER WILL BE USED AS THE FILL CHARACTER. 

IF TWO CHARACTERS ARE ENTERED, THEY WILL BE REGARDED AS THE HEXADECIMAL 
CODE FOR A SINGLE CHARACTER AND SHOULD BE IN THE RANGE 0-9/A-F. 

IF IT IS NOT IN THE RANGE HEXADECIMAL 20-5D-60-7E XXXXXXX, THE FILL 
CHARACTER WILL APPEAR AS A ? WHEN DISPLAYED IN RECORD ENTRY FIELDS IN 
THE RECORD INPUT/EDIT SCREEN IF INPUT MODE IS ASCII. 


NON-DISPLAYABLE CHARACTERS IN RECORDS OF DATA FILES (ASCII MODE). 


WHEN USING ANY FUNCTION ON A DATA FILE IN ASCII MODE, ANY CHARACTER IN 
A RECORD TO BE DISPLAYED WHICH IS NOT WITHIN THE RANGE HEX. 20-5D/60-7F 
WILL APPEAR AS A ?. IN THE CREATE AND UPDATE FUNCTIONS, ? CHARACTERS 
MAY BE ALTERED IN THE SAME WAY AS DISPLAYABLE CHARACTERS IF THEY APPEAR 
IN THE RECORD ENTRY FIELDS IN THE RECORD INPUT/EDIT SCREEN. 

IF THE INPUT/EDIT SCREEN IS TRANSMITTED WITH ? CHARACTERS IN THE RECORD 
ENTRY FIELDS, EACH CHARACTER CORRESPONDING TO A ? WILL REMAIN UNALTERED 
IN THE ACTUAL RECORD. 


IN SOURCE TYPE FILES, THE ? WILL BE TREATED AS A NORMAL CHARACTER, 
NOTE. UNDERSCORE, UP-ARROW AND DEL CHARACTERS ARE CONVERTED TO A ? 


PRESS "XMT" TO CONTINUE 


en 
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Ae a ea ee ee 
Screen 13 — Help 3. 


————— eee 
FOR THIS PROGRAM TO RUN EFFICIENTLY, IT IS VITAL THAT THE USER WAITS FOR 
A COMPLETE SCREEN TO BE DISPLAYED ON THE TERMINAL BEFORE ENTERING AND/OR 
TRANSMITTING INFORMATION BACK TO THE PROGRAM, TO TRANSMIT, PRESS THE 
"XMT" KEY ONCE ONLY, 


IF AN INVALID REQUEST IS ENTERED IN AN ENTRY FIELD ON A SCREEN,THAT SAME 
SCREEN WILL BE RE-DISPLAYED BY THIS PROGRAM. THE FIRST INVALID ENTRY 
WILL BE HIGHLIGHTED AND A MESSAGE IDENTIFYING THE ERROR WILL BE DISPLAY- 
ED ON THE LAST LINE OF THE SCREEN. THE INVALID ENTRY SHOULD BE CORRECTED 


IF THE INFORMATION DISPLAYED BY THE PROGRAM BECOMES OVER-WRITTEN OR 
ERASED, THE USER CAN REFRESH THE SCREEN BY DOING THE FOLLOWING. 


PRESS "HOME" KEY, ENTER "O", PRESS "XMT" KEY, 


WHEN THE SCREEN IS RE-DISPLAYED, THE ENTRY FIELDS WILL BE FILLED WITH 
THE INFORMATION WHICH WAS ORIGINALLY DISPLAYED BY THE PROGRAM ON THIS 
SCREEN. IF THE REFRESH OPTION IS REQUESTED WHILE USING THE RECORD INPUT / 
EDIT SCREEN, THE ACTUAL RECORD INFORMATION WILL RE-APPEAR IN THE RECORD 
ENTRY FIELDS. 


PRESS "XMT" TO RETURN TO FUNCTION SELECTION 
ee 


If the HELP function is selected in screen 1, the utility displays screens 11, 12 and 13 and then re- 
displays screen 1. 


The characters UNDERSCORE/f£5E and UP-ARROW/E5F are converted because it is possible for the 
TD 830 type terminals to be configured to interpret these characters as unprotected data entry and ter- 
minate forms delimiters when they are received in forms mode. 


Screen Messages 
If invalid input is entered in the entry fields on any screen or any error condition is detected, the same 
screen is re-displayed with one of the following messages displayed in the bottom line. All data as orig- 


inally transmitted is re-displayed. 


Field Entry Error Messages May be displayed on screens: 


1. ERROR — HIGHLIGHTED ENTRY MUST NOT BE SPLIT 1-9 
2. ERROR — HIGHLIGHTED ENTRY MUST NOT BE BLANK 1-9 
3. ERROR — HIGHLIGHTED ENTRY MUST BE NUMERIC 1-9 
4. ERROR ~ HIGHLIGHTED ENTRY SHOULD NOT BE GREATER THAN xxx 1-9 
5. ERROR — HIGHLIGHTED ENTRY SHOULD NOT BE LESS THAN xxx 7 

6. ERROR ~ HIGHLIGHTED ENTRY MUST NOT BE ZERO 1-9 
7. ERROR — BLOCK SIZE MUST BE A MULTIPLE OF RECORD SIZE 2 

8. ERROR — INVALID CHARACTER IN IDENTIFIER 1,7 
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(continued) 
Field Entry Error Messages May be displayed on screens: 


9. ERROR — START POSITIONS MUST BE ENTERED IN ORDER 5 

10. ERROR — NO START POSITIONS HAVE BEEN ENTERED 5 

11. ERROR — BLANKED OUT CHARACTERS WERE NOT HEXADECIMAL 6 

12. ERROR — INVALID INFORMATION RECEIVED — PLEASE RE-ENTER 6 

13. ERROR — HIGHLIGHTED ENTRY MUST BE NUMERIC OR ‘“‘FIND’”’ 6, 8 

14. ERROR — NO KEYS HAVE BEEN SPECIFIED FOR FIND COMMAND 6, 8, 9 
9 


15. ERROR — TEST MUST BE ‘“‘=”,, “<”’, “>”, “<=” or “=>” 


Message 11 may only be displayed in the Record Input/Edit function screen (6) if the input mode is 
hexadecimal and characters not in the range 0-9/A-F have been entered in record data entry fields. 
These non-hexadecimal characters are replaced by blanks when the screen is re-displayed. 


Message 12 will be displayed if the <rec.check> field does not contain the expected string when trans- 
mitted back to the program. This may happen if the user depresses the ‘‘XMT’’ key more than once 
when transmitting. 


File Error Messages 


The foliowing messages may be displayed on screen 1 (SELECT function) and screen 7 (COP 
only. 


Message May be displayed on screens: 


1. CANNOT FIND FILE ffffffffffff ON DISK ddddddd 1,7 
2. FILE ffffffffffff ON DISK ddddddd IS INCOMPLETE 1 
3. FILE ffffffffffff ON DISK ddddddd IS IN USE 1,7 
4. DISK ddddddd IS NOT AVAILABLE Le 
5. DISK ddddddd IS LOCKED 1,7 
6. FILE ffffffffffff ALREADY EXISTS ON DISK ddddddd 1 
7. FILE ffffffffffff ON DISK ddddddd IS NOT SOURCE OR DATA TYPE 

8. FILE ffffffffffff ON DISK ddddddd IS NOT SOURCE TYPE 

9 


10. RECORD SIZE OF FILE ffffffffffff ON DISK ddddddd IS NOT rrr 
11. FILE ffffffffffff ON DISK ddddddd HAS NO RECORDS 


12. RECORD SIZE OF FILE ffffffffffff ON DISK ddddddd IS GREATER THAN 
2000 


13. DIRECTORY OF DISK ddddddd IS FULL 1 


1 
7 
_ FILE ffffffffffff ON DISK ddddddd IS NOT DATA TYPE 7 
7 
1 
1 


Remove Function Message 
1. FILE ffffffffffff REMOVED FROM DISK ddddddd 
This message is displayed when a file has been successfully removed from a disk. 
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Copy Messages 


1. >>>>>RECORD<S> BEING COPIED — PLEASE WAIT...... 


This message flashes until copying of records is complete; the following message is then displayed. 


2. XXxXxxxx RECORDS COPIED TO FILE ffffffffffff ON ddddddd STARTING AT REC. 
YYVVYVYY 


Copy Error Messages 
1. NO RECORDS COPIED-BAD RECORD xxxxxxx IN FILE ffffffffffff ON ddddddd 


2. ONLY xxxxxxx RECORD<S> COPIED-BAD RECORD yyyyyyy IN FILE ffffffffffff ON 
ddddddd 


3. RECORD xxxxxxx IN FILE ffffffffffff ON ddddddd IS BAD 


A read error has been detected on the Secondary file. Message 3 may also be displayed on Screen 8 
{record display). 


4. NO RECORDS COPIED-MAX. SIZE OF FILE ffffffffffff ON ddddddd CANNOT BE EX- 
CEEDED 


Find Command Messages 
1. >>>>> SEARCHING FROM RECORD xxxxxxx — PLEASE WAIT..... 


2. >>>>> END OF FILE REACHED ~ NOW SEARCHING FROM START — PLEASE 
WAIT 


3. RECORD FOUND 

4. NO RECORD FOUND 

5. FIND COMMAND TERMINATED 
Message 5 will be displayed if the user has pressed XMT key to terminate search. 
The above messages may be displayed on the FIND information screen (10). 


The following messages may be displayed on the record input/edit (6) and the record display (8) screens 
when the FIND command has been terminated, has found a record, or has failed to find a record. 


1. FIND COMMAND TERMINATED AT RECORD xxxxxxx: 

2. THIS RECORD CONTAINS THE SPECIFIED KEY(S) AT POSITION(S) a bc 
3. NO RECORD FOUND IN FILE WITH SPECIFIED KEY(S) 

4. THIS RECORD IS FILLED WITH ‘‘X’’ CHARACTERS 


5. NO ‘‘X”? FILLED RECORD FOUND IN FILE 
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No Disk Space Message 
1. >>>>> WAITING FOR SPACE FOR FILE ffffffffffff ON DISK ddddddd..... 


This message may appear on screen 4 (record Input/Edit) or screen 7 (Record Copy) if an area for 
the file being created or modified cannot be allocated. Operator intervention is required to resolve the 
situation. This message continues to flash until space is made available for the file (or another disk 


: : a: 
is AD’ed to the utility). 


Input Or Output Parity On A File Being Created Or Modified 


If an error is detected by the utility when inputting or editing a record via screen 6 (Record Input/ 
Edit) in the CREATE or UPDATE functions, or when copying records from a file using the COPY 
function, the utility terminates the function and displays the following screen. 


PERMANENT ERROR DETECTED ON FILE ffffffffffff ON DISK ddddddd. 
RECORD xxxxxxx IS BAD. 


RECOVERY OF THIS FILE MAY BE POSSIBLE. 


CREATE A NEW VERSION OF THE FILE BY USING THE CREATE FUNCTION. COPY 
GOOD SECTIONS OF THE OLD FILE TO THE SAME LOGICAL RECORD POSITION IN 
THE NEW FILE USING THE COPY OPTION. 

EACH BAD RECORD IN THE OLD FILE WILL HAVE TO BE REPLACED IN THE NEW 


FILE BY INPUTTING A NEW RECORD WITH THE SAME RECORD NUMBER INTO THE 
NEW FILE USING THE RECORD INPUT/EDIT SCREEN. 


THE NEW FILE SHOULD BE BUILT SEQUENTIALLY - A REPLACEMENT FOR A_ BAD 
RECORD SHOULD BE INPUT INTO THE NEW FILE BEFORE A SUBSEQUENT GOOD 
SECTION OF THE OLD FILE IS COPIED TO THE NEW FILE. 


THE NEXT SCREEN TO BE DISPLAYED IS FOR FUNCTION SELECTION. 


ee 


The utility then displays Screen 1. 
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FL (Display File Attributes on Self-Scan — B 90 Only) 


This utility allows the operator to display detailed information about particular files or groups of files 
on disk. The information given is similar to the LR utility, and is displayed on a console screen, or 
console printer if no console screen is available. This utility supports the starfile option * < file-name> 
in the initiating message. 


Format: 


< disk-name > / < filename > 
< group-name > 


The utility uses the following PKs when more than one file is specified: 


PKI PK6 
NEXT END 
Examples: 


To display information about all entries on the system disk: 
FL = 

To display information about a file called PR200 found on disk called PR2: 
FL PR2/PR200 


To display information about a group of files beginning with the letters “‘PR’’ found on the system 
disk: 


FL PR = 
Output Format: 


Information from this utility can be output in one of two forms depending on the size of screen being 
used. For a CRT configured to be 40 or more characters wide, or for a console printer, the six-line 
format is as follows: 


Line 1 FILE ddddddd/ffffffffffff filetype @ft@ 

Line 2 ACTUAL SIZE xxxxxxx : RECORD SIZE xxxxx 
Line 3 MAXIMUM SIZE xxxxxxx : RECS/BLOCK xxxxx 
Line 4 DATE CREATED yyddd : ACCESSED yyddd 
Line 5 AREA MAP : 3 oie ie 2k ok 2 2k 2k ok ok oe ok Kk 

Line 6 OVERFLOW ON DISK : ddddddd 


For a CRT configured to 32 characters wide or for a SELF-SCAN, the format is as follows: 
Line 1 FILE NAME: ddddddd/ffffffffffff 
Line 2 FILE TYPE: filetype @ft@ 


Line 3 SIZE: ACTUAL xxxxxxx, MAX xxxxxxx 
Line 4 CREATED ACCESSED REC.SZ RECS/BLK 
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Line 5 yyddd yyddd xxxxx xxxxx 

Line 6 AREA MAP: ***# #444845 444% 

Line 7 OVERFLOW ON DISK: ddddddd PSEUDO) 
Line 8 


Note that the AREA MAP entries will show * for unallocated areas, B for areas allocated on this disk 
and O for areas allocated on the overflow disk. 


If the file is dual-pack and the overflow disk is not available, the last line of each format will include 
“FILE INCOMPLETE”’ 


Note that the OVERFLOW ON DISK will not be displayed if the file has no overflow areas allocated. 


The first line contains the disk name specified by DDDDDDD on which the file specified by 
FFFFFFFFFFFF resides. 


The filetype entry will contain one of the following: 


Filetype Entry in Listing/Display 
@0@ DATA @00@ 
@01@ -— @0E@ SRCLANG @0x@ 
@0F@ SRCLIBR @0F@ 
@10@ - @13@ CYYMMDD @1x@ 
@2i@ SYSLANG @21@ 
@22@ SYSDATA @22@ 
@30@ VIRTMEM @30@ 
@31@ SYSLOG @31@ 
@81@ KEY @81@ 
@AV@ PRNTBKP @AV@ 
Any other SYSTEM @xy@ 
ACTUAL SIZE The actual file size specified for the file. 
MAXIMUM SIZE The maximum file size specified for the file. 
RECORD SIZE Number of characters per second. 
RECS/BLOCK Number of records per block. 
DATE CREATED Date of creation. 
ACCESSED Date the file was last accessed. 
AREA MAP 16 characters to show the allocation of the 16 areas into which a 


file may be broken. 


Entries for AREA MAP are as follows: 


Entries Area Allocated On: Possible Disk 
Types 
= Unallocated 1 2 or 3 
B Base disk 1 
O Overflow disk 1 or 2 
U Physical unit 2 or 3 
A Another physical unit 3 
Disk Types: 
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Entries 


Wh ee 


(continued) 


Area Allocated On: Possible Disk 


Types 


non-pseudo disk 
restricted pseudo disk 
unrestricted pseudo disk 


The two component disks of a dual-pack file can be: 


Two non-pseudo disks 
or 


One non-pseudo disk and one restricted pseudo disk. 


“UNIT : uguuuuv’’ 


‘UNRESTRICTED PSEUDO’”’ 


“OVERFLOW DISK : oo00000’’ 


Output Messages 


is only displayed if ddddddd is a pseudo disk; 
uuuuuuu being the physical unit on which this 
file directory information was found. 


is displayed only if ddddddd is an unrestricted 
pseudo disk. 

is only displayed if the file is a dual-pack or an 
unrestricted pseudo disk file, and one or more of 
the disk or units on which areas and/or directory 
entries for this file are not available. 


is only displayed if the file is a dual-pack. 


Message Possible Cause Suggested Action 
<file name> NOT LISTED The utility could not list the See the second error message 
specified file. The reason is given for the reason. 
given in the second message. 
<family name> NOT The utility could not list the See the second error message 
LISTED specified file. The reason is displayed for the reason. 


given in the second message. 


Note: Refer to ‘‘Common Utility Output Messages’? for additional aid. 
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FS (File Squash) 


This utility allows the operator to remove all deleted records from a data file. Records are normally 
‘‘deleted’’ (that is, hexadecimal @FF@ is written over the records) through an appropriate application 
program. The FS utility will remove these previously deleted records, allowing additional records to 
be added to the file. 


< disk-name > / 


LC < disk-name > / 7 
FS < filename > 


The ‘‘filename”’ identifies either a data file or a keyfile. If a keyfile has been specified, the name of 
the data file is obtained from the information held in the keyfile. 


INTO < filename > 


If a keyfile is specified, then the utility will reconstruct this keyfile so that it relates to the modified 
data file. 


If an index file is specified for squashing, the utility will display the message: 
<keyfile-name> IS ASSOCIATED WITH <datafile-name> 

If an INPLACE squash is being done, the keytile will be removed and the message: 
<keyfile-name> REMOVED 

is displayed. 


While the utility is processing, no other program may access the data file (or the keyfile if one is 
specified). 


If only one file-name is specified, and no other options are used, the file squash will be carried out 
in place, and no new data file will be created. If a keyfile was specified, then a new keyfile with the 
same ‘‘file-name’’ will be recreated by the SORT. 
If two file-names are specified, the data file will be squashed into a new file, and the keyfile (if 
specified) will be recreated by the SORT. If the first filename specifies a keyfile, then the new keyfile 
will have the name indicated by second file-name, and the new data file will have the name of the 
new keyfile name, with the letters ‘“QQ’’ attached to the end of the name. 
Examples: 
To squash the file, PR200: 

FS PR200 
To squash the file, PR200 and create a new file, PR200B: 


FS PR200 INTO PR200B 
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Output Messages — 


Message 
UNABLE TO ZIP SORT 


—RECORD SIZE LIMIT IS 
1000 


<file name> SQUASHED 
FROM n RECORDS TO m 
RECORDS 


KEYFILE <file name> 
RECONSTRUCTED 


—HARDWARE ERROR 
DETECTED WHILE 
READING KEYFILE <file 
name> 

—KEYFILE <filename> 


WAS NOT CREATED FOR 
DATAFILE <filename> 


—NO RECORDS IN 
KEYFILE <filename> 
—<filename> IS NOT A 
DATAFILE 


UNABLE TO ACCESS 
< filename > 


~—~UNABLE TO ACCESS 
ASSOCIATED DATAFILE 
< filename > 


Possible Cause 


SORT utility is not initiated. 
The reason is given by the 
second message displayed by 
the utility. 

An attempt was made to 


squash a file with a record 
size greater than 1000 bytes. 


FS successful. 


FS successful. The data file 
associated with specified 
keyfile has squashed 
successfully and SORT 
reconstructed the keyfile. 


The utility has encountered an 
error while reading the 
specified keyfile. 


SORT was not successful. 


The keyfile to be FS’ed is 
empty. 

The specified datafile is not 
of type data or source. 

The specified file is not on 
the specified disk. 

The datafile with the filename 


found in the keyfile is not 
available to the system. 


Suggested Action 


See the second error message 
displayed for the reason. 


None. Utility limitation. 


None. 


None. 


Run FS on the datafile then 
SORT the datafile to obtain a 
new keyfile. 


Refer to the output messages of 
SORT to detect the reason for 
the failure. 


Run SORT on the related 
datafile to obtain a new keyfile. 


Check input for correct file 
name. 


Make file available and re-enter. 


Make file available and re-enter. 


Note: Refer to ‘‘Common Utility Ouput Messages’? for additional aid. 


NOTE 


It is strongly recommended that FS, once loaded, is not DSed. 
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ICMD 


The ICMD utility allows the operator to access industry compatible mini disks. 


Version 1 
‘a < disk-id > — 
ICMD—LR ni = a 
< string! > 
Version 2 


a inprronee ar seers 
ICMD—COPY < disk-name > / < file-name > TO 


< string 1 > 
< file-id > 
a B ICMD — ALIGN 


L < string 2>—4 


oa 


Version 3 


< disk-id > < file-id > 
iCMD—COPY 4 i= a icMD ————— TO. —______> 
< string 2> < string 2 > 
< disk-name >/ < file-name > FILESIZE < integer > 


Version 4 


< disk-id > 
< string! > 
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Version 5 
< disk-id > < disk-id > 
< string! > < string! > 


<disk-id > Is the volume identifier of an Industry Compatible Mini Disk (ICMD) and 
does not exceed six valid CMS characters. 


< owner-id > 


< string 3> 


< file-id > Is the name of a file on an ICMD and does not exceed eight valid CMS 
characters. 

<owner-id > Is an identifier not exceeding 14 valid CMS characters. 

<string! > Is a sequence of characters bounded by quotes, not exceeding six 
characters. Alternative to <disk-id>. 

< string2 > Is a sequence of characters bounded by quotes, not exceeding eight 
characters. Alternative to <file-id>. 

<string3 > Is a sequence of characters bounded by quotes, not exceeding 14 
characters. Alternative to <owner-id>. 

<disk-name > Is a CMS standard disk name. 

< file-name > Is a CMS standard file name. 

NOTE 


A quote may be included in the string by substituting a pair of quotes. 


The first version allows the operator to list the directory of an ICMD. The utility will print a line 
of information for each file on the disk. 


The second version allows the operator to copy a CMS file to an ICMD file. If B is specified, any 
file may be copied without loss of attributes but it may only be copied back by this utility. The file 
may be accessed by other systems but it must be a data or source file with a record size not exceeding 
128. If the keyword ALIGN is specified, the file will be copied to the ICMD so that the start of the 
file is at the beginning of a track. 


The third version allows the operator to copy an ICMD file to a CMS file. Files originally copied by 
this utility using the B option will be restored as they were. Other files will be restored as data files 
with the largest possible block not exceeding 180. If the FILESIZE of the CMS file is not specified, 
it will be calculated from the header of the ICMD file. 


NOTE 
When copying a Multi-volume file which was generated without the B option, 
the utility will insist on this attribute. 


The fourth version allows the operator to purge all files on an ICMD. The utility will replace all files 
by a single zero-length file named DATA to which all the disk space available to the user is allocated. 
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The fifth version is similar to the fourth but re-labels the ICMD. The new label will record whatever 


owner-id is specified. 


Examples 


To print the disk directory of an ICMD disk called PR2: 


ICMD LR PR2 


To purge all the files from the ICMD called PR2 and name it as PR3: 


ICMD PG PR2 TO PR3 


To copy a file called PR200 from the CMS disk called PRI to an ICMD disk called PRBU: 
ICMD COPY PRI/PR200 TO PRBU/PR200 ICMD 


To copy a file called PRFILE from the ICMD called PRBU to the CMS disk called PRI: 
ICMD COPY PRBU/PRFILE ICMD TO PRI/PR200 


To copy a file called !! from the ICMD called FRED* to the file called CMSFILE on the CMS disk 


called CMSDISK: 


ICMD COPY ‘‘FRED*’’/“!!”? ICMD TO CMSDISK/CMSFILE 


Output Messages 


Message 
<filename> NOT COPIED 


INVALID CHARACTER IN 
IDENTIFIER <string> — 
WARNING 


— <filename> IS ALREADY 
ON DISK 


—PARAMETER 
FOLLOWING KEYWORD 
<string> IS INVALID 


<filename> REMOVED 


—HARDWARE ERROR 
DETECTED WHILE 
WRITING TO FILE 

< filename > 


<filename> COPIED TO 
< filename > 


—NO SPACE ON DISK 
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Passibie Causes 


ICMD could not copy the 
specified file. The reason is 
given in the second message. 


The specified string does not 
comply with ICMD standards. 


The specified file cannot be 
copied to ICMD as a file of 
the same name already exists. 


There is an error in the 
initiating message. 


A CMS file was removed by 
the utility to make way for 
another file being copied from 
ICMD. 


The utility has detected an 
error while writing to the 
specified file. 


ICMD COPY successful. 


Self-explanatory. 


Suggesied Action 
Look for the reason in the 
second error message displayed. 


Check input for correct 
characters used in identifier. 


Copy this file to another name. 


Correct input and re-enter. 


None. 


Check integrity of output 
medium. 


None. 


Select a disk with enough 
unused space to copy to. 
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Message 


—RECORD SIZE EXCEEDS 
128 


~BAD INDEX TRACK ON 
<diskname> SECTOR 
<number > 


VOLUME n OF <filename> 
OUT OF SEQUENCE 


NEXT SEQUENCE 
NUMBER OF <filename> 
EXCEEDS 99 


ENTER DISKNAME FOR 
<filename> n 


FILESIZE IS REQUIRED 
FOR <filename> 


<diskname> PURGED 


“DATA” IS A RESERVED 
FILENAME 


—SPECIFIED FILESIZE IS 
TOO SMALL 


NO FREE LABEL ON 
<disk-name> 


(continued) 
Possible Causes 


The file cannot be copied to 
the ICMD as its record size is 
greater than 128. 


ICMD has an error on track 
0 and cannot be used by this 
utility. 


The utility expected another 
disk as the next disk in a 
multivolume file copy. 


No more disks may be used, 
as the maximum for an 
ICMD is 99. 


The utility requests the multi- 
volume filename and the 
sequence number to be used. 


The attribute FILESIZE must 
be specified when copying a 

multi-volume ICMD file if it 
was created without the ‘‘B’’ 
option. 


Successful completion of an 
ICMD PG function. 


An attempt was made to 
create a file with the filename 
‘““DATA’’, which is a reserved 
word. 


The filesize specified in the 
FILESIZE attribute is too 
small. 


File cannot be copied to 
ICMD as its directory is full. 


Refer to Common Utility Output Messages for additional aid. 
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Suggested Action 


Use CMS COPY utility to 
change record/block sizes. (For 
example, COPY CMSFILE TO 
CMSFILE RECORD 128 
BLOCK 128) Then use ICMD 
COPY to complete transfer. 


Select another disk for this 
function. 


Remove inappropriate disk and 
supply the disk with the correct 
sequence number. 

Use CMS COPY to break file. 
Then re-run ICMD. 


Enter appropriate diskname and 
sequence number. 


Re-enter with filesize option in 
initiating message. 


None. 


Use another name and re-run 
the function. 


Rerun the function with a larger 
filesize. 


Select another disk which has 
directory space. 


IR (Initiate Log Recall) — 
(a function of SYS-SUPERUTL) 


This function will initiate recall and go back in SYS-LOG files after skipping the number of entries 
specified by the operator (that is, 5 digit ‘‘offset’?) and display the required message. 


Format: 


END 
where <offset> is a 5-digit number signifying the number of log entries to be skipped before 


displaying logged messages. 


The characters in the range hexadecimal @00@ to @1F@, @7F@ to @9F@ and @FF@ inclusive 
will be replaced by spaces. 


Examples: 

To initiate recall after 12 entries and display the message on the console: 
IR 12 

To initiate recall of the message just given: 


IR 1 


NOTE 
Only log entries which originated at the SPO requesting recall can be recalled, 
unless it is the controlling SPO, in which case all log entries can be recalled. 


Output Messages 


Message Possible Causes Suggested Action 
CANNOT LOCATE The log files have been Decrease the value of offset and 
DESIRED ENTRY transferred using TL utility, re-enter. 


or offset is greater than 
number of entries in log file. 


For additional information, refer to LD function. 
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KA (Analyze Disk Space Assignment) 


This utility provides the operator with a map of all space used on disk by specific files, or available 
for other use. The printout is in ascending disk address order in terms of areas and their assignment. 


KA is capable of analyzing space assigned to one or more files, one or more groups of files, or the 
available areas. 


Special reporting is given if the group identifies all files on the disk (that is disk-name/=). In addition 
to an analysis of the areas allocated to each file, this report will show the space assigned to the disk 
directory, temporary, available, bad, and missing areas. The temporary areas are those which are allo- 
cated either to temporary files or to the virtual memory. 


If files are created, extended or deleted by the system during the processing of KA, the map will not 
be accurate. It is therefore necessary that KA be run only when no other programs are in the mix. 


The analyzed output will be to a line or console printer, and will print the areas in ascending disk 
address order associating with each area its first sector address, its length in sectors and its status. The 
status will be either allocated, available, temporary, bad or missing. If the area is allocated, the file 
name of the file to which the area is assigned will also be listed. If a particular file or family is not 
on-line, then this is indicated on the printout. 


If the option DSKAVL is selected, then an analysis of the available areas on the disk specified by 
“‘disk-name’’ (or system disk if no ‘“‘disk-name’’ was specified) will be printed. 


< family-name > , 
< filename > 


Format: 


< disk-name > / 


KA 


KA <disk-id >/ 


DSKAVL 


Examples: 


To analyze disk space assignments of all files on system disk: 
KA = 


To analyze disk space assignments of all files on the disk called PR2: 
KA PR2/= 


To analyze disk space assignments for a group of files beginning with the letters ‘‘PR’’ on the system 
disk, and a file called PR200 on a disk called PR2: 
KA PR= PR2/PR200 


To analyze available areas on the disk called PRBU: 
KA PRBU DSKAVL 
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Output Format 
Display of Bootstraps 


Depending on the settings of the initialization system field, MTR field and Coldstart flag in the label 
and also the disk type, the Disk/Bootstrap types will be identified by one of the following entries which 
will be printed in the banner heading of KA: 


““<CMS/WARMSTART DISK”’ Removable disks only CMS — B 90 
““BOOOSYSTEM DISK” Removable disks only B9IOOSYSTEM — B 900 
“MTR DISK”’ Removable disks only 
“CMS/WARMSTART&MTR DISK”’ Fixed disks — B 90 

“ROOOSYSTEM&MTR DISK’’ Fixed disks (and packs on B 900) 
‘“SCOLDSTART DISK’’ Mini disks — B 90 only 


The Bootstrap version number will only be displayed if the Bootstrap located in sectors 2-31 contains 
its own version number and the correct checkstring. The text 


“BOOTSTRAP VERSION <version number >” 
will be printed following the Disk/Bootstrap type. 


or disks which have been initialized on a B 1900 system, no Disk/Bootstrap type or version number 
displayed. 


Six columns of information are output. The column headings, the format of the values these columns 
contain, and the significance of these values are as follows: 


Heading Value Significance 
AREA ADDRESS 8 digits Sector address of start of area 
6 hex. digits 
AREA LENGTH | 8 digits Number of sectors in this area 
6 hex. digits 
STATUS 9 characters See Note 1. 
FILE NAME 12 characters See Note 2. 


Note 1: The status will be one of AVAILABLE, TEMPORARY, BAD or *MISSING*, depending on 
whether the area is available, allocated to a file, denoted as temporary, unusable or lost. 


Note 2: If the area is ASSIGNED, then this field will contain the identifier of the file residing in the 
area. If a file belongs to a pseudo disk, its disk name is also listed. Otherwise it will be blank. 


The status *MISSING* occurs if an area is not referenced from anywhere within the file directory or 
available table. This may be because the area is in fact lost, or because existing files have been opened, 
have had further areas allocated to them and are still open during the processing of KA. 


If fixed disk is being used, three areas are reserved for MTR purposes with the status marked as 
“BAD”. The area lengths are 256, 128, and 128 sectors respectively. 
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Output Messages 


Message 
<filename> NOT LISTED 


FAMILY <family name> 
NOT LISTED 


—<diskname> IS NOTA 
PHYSICAL DISK 


*AREA APPARENTLY 
ASSIGNED TWICE* 


*AREA ASSIGNED 
BEYOND MAXIMUM 
ADDRESS* 


*THIS AREA IS MISSING* 


Possible Causes 


The utility could not list the 
specified filename. The reason 
is given in the second message 
displayed. 


The utility could not list the 
specified family. The reason is 
given in the second error 
message displayed. 


An attempt was made to run 
KA on a pseudo disk. 


Area is contained partly or 
completely in an area 
previously listed. 


Area is assigned beyond the 
addressable space. 


Area is not referenced from 
anywhere within the file 
directory or the available 
table. 


Suggested Action 


Refer to the second error 
message to find the reason. 


Refer to the second error 
message to find the reason. 


Run KA on physical disk 
containing the pseudo disk. 


Run SQ <diskname> VERIFY. 
If, after successful completion of 
the SQ, the problem still exists, 

ask for technical assistance. 


If, after successful completion of 
the SQ, the problem still exists, 

ask for technical assistance. 

Run SQ <diskname> VERIFY. 
If, after successful completion of 
the SQ, the problem still exists, 

ask for technical assistance. 


Run SQ <diskname> VERIFY. 


Note: Refer to ‘“‘Common Utility Output Messages’’ for additional aid. 
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KEY.CHECK 


This utility allows the operator to chéck and print the information on the validity of keys in an indexed 
pair of files. 


Format: 


KEY.CHECK NOPRINT disk-name / keyfile-name <BOTH > 


This utility does not provide the *<file-name> option in the initiating message. 


During the execution of the utility, the operator is informed if the data file has been updated via an- 
other key file or parity errors have occurred on the data file since creation of the specified key file. 
The checking is performed in two ways, Key file to Data file check, and Data file to Key file check. 


In Key file to Data file checking, the key value field of each entry in the key file is compared with 
the key field in the corresponding record of the data file. This comparison will detect any changes to 
the keys in the data file records and disused entries in the key file. 


In Data file to Key file checking, the key field of every non-deleted record in the data file will be 
checked to have an entry in the key file. The record written to the data file via another key file and 
records with invalid keys will be detected, as they will have no entry in the key file. 


The NOPRINT option is provided to permit execution of the utility on a system with no printer. It 
is invoked by specifying NOPRINT at the beginning of the initiating message. 


SPO messages are provided for resulting output from KEY.CHECK with the NOPRINT option 
specified. A message is displayed for only the first discrepancy the utility finds between the key file 
and the data file (see Output Messages). 


If the <BOTH> option is specified in the initiating message, then Key file to Data file and Data file 
to Key file will be checked, otherwise only Key file to Data file will be checked. 


The utility will terminate if a parity error is encountered on the key file. 


If the Generation number of the key file differs from that of the data file, then a warning is printed. 
(Generation number is a field in the File Parameter Block, refer to MCP manual.) 


The Generation number of the key file will be modified to that of the associated data file on comple- 
tion of a Key file to Data file check provided that the following conditions are satisfied: 


1. Every key entered in the key file matches the key field in the associated data file record. 

2. Every non-deleted data file record has a key entry in the key file. 

3. The number of matched key entries in the key file is equal to the number of data file records 
with a key entry in the key file. 

4. There are no parity errors on either the key file or the data file. 


On completion of a printer listing execution of this utility, the total number of discrepancies found 
on checking each file is printed on completion of the key file and data file check. 
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Keys printed by the utility will be displayed both in ASCII and hexadecimal. 


KEY.CHECK will open the keyfile and datafile with OTHERUSE of LOCK.ACCESS. This means that 
no other program can use the keyfile and datafile while KEY.CHECK is using these files. 


The following message will now be displayed (if NOPRINT was specified) or will appear in the summa- 
ry section of the printer listing if the number of matched keyfile entries is not equal to the number 
of datafile records with a key in the keyfile. 


“THE NUMBER OF MATCHED KEYFILE ENTRIES IS NOT EQUAL TO THE NUMBER OF 
DATA RECORDS WITH A KEY IN THE KEYFILE’”’ 


The files will not be consistent if the message is displayed. 
The following totals will also be included in the summary section of the printer listing. 
““NUMBER OF MATCH KEYFILE ENTRIES — x’? 
“NUMBER OF DATAFILE RECORDS WITH A KEY IN KEYFILE — y” 
Output Format 
The output format is self-explanatory. 
Examples 


Check the key file PQR, performing Key file to Data file check 
KEY.CHECK PQR 


only: 


Check the key file PQR, performing Key file to Data file check as well as Data file to Key file check: 
KEY.CHECK PQR <BOTH> 


Output Messages 


Message 


<filename> NOT 
CHECKED 


—FILE IS NOT A KEYFILE 


—FILE IS A NULL-KEY 
KEYFILE © 


—HARDWARE ERROR 
DETECTED WHILE 
READING KEYFILE 

< filename > 


—KEYFILE <filename> 
WAS NOT CREATED FOR 
DATAFILE <FILENAME> 
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Possible Causes 


The utility could not check 
the specified file. The reason 
is given in the second message 
displayed. 

Self-explanatory. 


The specified file is a tag-file, 
not a keyfile. 


The utility has encountered an 
error in the keyfile. 


The key offset and length of 
the keyfile are beyond the 
end of the data record. 


Suggested Action 


See the second error message 
displayed by the utility for the 
reason. 


None. 


See section 5 of SOG on SORT 
for meanings; this utility cannot 
check tagfiles. 


Remove keyfile and use the 
SORT utility to produce a new 
keyfile. 


Use the SORT utility to produce 
a new keyfile. 


oe ot ee a ee eS Ss See 


Message 


—NO RECORDS IN 
KEYFILE <filename> 


— <FILENAME> IS NOT 
A DATAFILE 


GENERATION NO. 
MISMATCH MATCH 
BETWEEN <keyfilename> 
AND DATAFILE 

< filename > 


FIRST INDEX 
DISCREPANCY FOUND 
BETWEEN KEYFILE 
<keyfilename> AND 
DATAFILE <filename> 


—~ <NUMBER> INDEX 
DISCREPANCIE(S) FOUND 
WITH <filename> 


<filename> CHECKED 


CHECK COMMENCING ON 
DATAFILE <filename> 


KEYFILE <filename> 
CURRENTLY INDEXES 
DATAFILE <filename> 


—~GENERATION NO. OF 
KEYFILE <filename> 
MODIFIED TO <number> 


—UNABLE TO MODIFY 
GENERATION NO. OF 
KEYFILE <filename> 


KEYFILE <filename> 
DOES NOT CORRECTLY 
INDEX DATAFILE 

< filename > 


KEYFILE <filename> IS 
ASSOCIATED WITH 
< filename > 


UNABLE TO ACCESS 
< filename > 
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(continued) 
Possible Causes 


Self-explanatory. 


The file identified in the 
KFPB of the specified keyfile 
as the associated datafile does 


not have a filetype @00@. 


The generation numbers of 
the files are inconsistent. 
After the KEY.CHECK, the 
generation number will be 
corrected. 


The first error has been 
encountered between the 
keyfile and the datafile. 


The check on the keyfile has 
been completed and ‘‘X”’ 
number of discrepancies have 
been found. 


Normal output message. 


The check on the keyfile has 
been completed and the 
datafile check has been 
invoked. 


Shows which datafile is 
related to the specified 
keyfile. 


A generation number 
mismatch was found and a 
correction has been applied. 


Self-explanatory. 


Discrepancies have been found 
on one or both files. 


Shows relation between keyfile 
and datafile. 


The utility cannot run. The 
reason is given the second 
message displayed. 


Suggested Action 
None. 


Check the filename and re-enter. 


None. 


None. 


None. 


None. 
None. 


None. 


None. 


None. 


None. 


None. 


Look for the reason in the 


second message displayed by the 


utility. 
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(continued) 

Message Possible Causes Suggested Action 
—UNABLE TO ACCESS The utility cannot access the Look for the reason in the 
ASSOCIATED DATAFILE datafile related to the keyfile second message displayed by the 
< FILENAME > entered in the initiating utility. 


message. 
-NO. OF VALID KEYS IS Discrepancies have been found None. 
INCONSISTENT WITH THE on one or both files. 
NO. OF RECORDS 
CONTAINING DATA 
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KX (Disk Allocation Information) 

(a function of SYS-SUPERUTL) 

This function will allow the operator to display the names of all the files found on the disk specified 
by ‘‘disk name’’ (or on the system disk if no “‘disk-name’’ is specified) whose total number of sectors 


allocated is equal to or greater than ‘‘number”’ (assumed zero if not specified). The disk concerned 


may not be a pseudo pack. 


KX 


< disk-name > 
< number > 


After each display, which will include the information of the current numbers of temporary and avail- 
able sectors, the KX function of SYS-SUPERUTL remains available, waiting for one of the following 


input responses: 
A call on any other function of SYS-SUPERUTL: this will terminate KX. 
KX or KX NEXT To display the next file name, if any, otherwise KX will go to END. 
aot ae lene Sazret am A: 


KX RM or KX REMOVE To remove the fiie whose aie has jist 
j 


KX END To terminate KX. 


NOTE 
The <number> option specifying the size of the files in KX can only be 
changed by ending KX and starting it again with another value in the num- 
ber. 


Examples: 


To display the name of the first file on a disk called ““SYS’’ whose size is equal to or greater than 
250 sectors: 


KX SYS 250 

To display the name of the next file whose size is equal to or greater than 250 sectors: 
KX NEXT 

To remove the file just displayed: 
KX RM 

To terminate KX: 


KX END 


2032801 4-161 


eee 
Output Messages 


Message Possible Causes Suggested Action 


<filename> OCCUPIES Normal output. None. 
<integer> SECTORS — 

TOTAL AVAILABLE 

SECTORS = n, TOTAL 

TEMPORARY SECTORS = 


< integer > 
— <disk> IS NOTA KX may not be run on a None. 
PHYSICAL DISK pseudo disk. 
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LB (Look Back in Log) 

(a function of SYS-SUPERUTL) 

This function will Look Back to continue recall in the direction of earlier messages with a screenful 
of messages. If the serial printer (SPA) is used as the console, then the function will display a number 


of messages calculated by the length of messages and width of console. 


It is possible to terminate this function by entering ‘‘LB END”’’, causing ‘END LB’ to be displayed. 


Railroad diagram: 


r= =| 


LB —_—_—_—_— Lt ——_—_—— 


Example: 


To look back and display the messages: 


LB 


LB can be initiated only after IR, LB, and LF. 


Message 


HARDWARE ERROR 
DETECTED BY <utility> 
RECALL MAY BE 
INCOMPLETE 


ENTRIES NOT RECALLED 


PREVIOUS FUNCTION 
WAS NOT <utility> 


—IR REQUIRED TO 
INITIATE LOG RECALL 


—CANNOT LOCATE 
DESIRED ENTRY 


—NO FURTHER ENTRIES 
FOR <utility> 


—<file> NOT A 
RECOGNIZED LOG FILE 
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Possible Causes 
Self-explanatory. 


Self-explanatory. 


An invalid END command 
was entered. 

An attempt was made to do 
an LB or LF without doing a 
IR before it. 

The offset in the IR 
command is too high. 

LB has reached the beginning 
of this log file, or LF has 
reached the end of the log 
file. 

The filetype of the logfile has 
changed. 


Suggested Action 
None. 


None. 
None. 


Initiate IR, then re-input LB or 
LF. 


Enter IR with a smaller offset. 


None. 


Error in SYS-SUPERUTL. Copy 
good SYS-SUPERUTL from 
backup disk and re-start the 
system. 
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LD — TAPE LIBRARY UTILITY (ADD, LOAD, DUMP, 
UNLOAD) 


The LD utility has two formats: 


Format 1. Loading files from TAPE onto DISK (ADD, LOAD) 
LOAD and ADD provide the capability of copying files or groups of files from a library 
tape to the disk specified by name. If no disk name is specified, the system disk is as- 


sumed. 
LOAD If LOAD is specified, the files are copied to the disk and any duplicate files are 
removed. 
ADD If ADD is specified, then only files which do not already have copies on the disk 
are loaded. 


Format 2. Dumping files from DISK to TAPE (DUMP, UNLOAD) 
DUMP and UNLOAD provide the capability of copying files or groups of files from the 
specified named disk to a library tape. If no disk name is given, the system disk is as- 
sumed. 


UNLOAD If UNLOAD is specified, then the files are deleted from the disk after they have 
been copied to the tape. 


DUMP If DUMP is specified, then the files are not deleted from the disk after they have 
been copied to the tape. 


If the utility LD resides on the system disk, only the function name has to appear in the initiating 
message. For example, the input 


DUMP TO ARTAPE AR= 
causes the same action as 
LD DUMP TO ARTAPE AR= 


If the LD utility does not reside on the system disk, then the initiating message must contain ‘‘< disk- 
name containing LD>/LD’’. 


Detailed descriptions of ADD, LOAD, DUMP and UNLOAD and associated output messages are pro- 
vided under the name of the function. 


“UPDATED” Bit Options 


1. DUMP All “UPDATED”? bits will be reset. 


2. DUMP & CHECK LD will not alter the ‘‘UPDATED”’ bits. At the end of 
the dump, LD will Close Release the tape and zip 
CHECKADUMP without pause before going to EOJ. 
CHECKADUMP will RESET the ‘“‘UPDATED”’ bit of any 
file which compares successfully. 
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NOTE: If CHECKADUMP is executed independently, it 
will not alter the ““UPDATED”’ bits. 


All “UPDATED” bits will be SET automatically by the 
MCP as a result of closing a new output file. 


This is identical to LOAD with regard to the 
“UPDATED” bits. The only difference is that LD will 
Close Release the tape at the end of the load, and Zip 
CHECKADUMP without pause before terminating. 
CHECKADUMP will not alter the ‘‘UPDATED”’ bits. 


5. DUMP UPDATED These operate like DUMP and DUMP & CHECK except 
and that only files with the ““UPDATED”’ bit SET will be 
DUMP & CHECK UPDATED candidates for dumping. The ‘“‘UPDATED”’ bit set 

indicates that the file has been created or updated since 
the last dump was taken. 


All “UPDATED” bits will be SET automatically by the 
MCP as a result of closing a new output file. 


Output Messages From LD — ADD/DUMP/LOAD/UNLOAD 


3. LOAD 


4. LOAD & CHECK 


6. ADD 


Message Possible Causes Suggested Action 


MOAANV 


<filename> REMOVED The utility hac successfully 


ALi’ UlLLiLy BLES Gwe wera wees 
loaded a file which was 
already on disk, or the 
utility has removed the file 
as a result of an UNLOAD 
request. 


The utility cannot find the 
datafile belonging to a 
keyfile it has to LOAD/ 
ADD/DUMP/UNLOAD. 


Self-explanatory 


None. 


~ ASSOCIATED DATAFILE Make file available and re-enter. 


<filename> NOT FOUND 


—FILE NAME <filename> Check input and re-enter. 
EXCEEDS 12 


CHARACTERS 


<filename> NOT LOADED The utility could not load Refer to the second error message 


—<tapename> IS NOT A 
RECOGNIZED LOAD/ 
DUMP TAPE 


<file-id> LOADED 


<file-id> DUMPED 


<file-id> NOT LOADED 
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the specified <filename>. 
The specified tape is not 


created using the LD utility. 


Normal operation. File with 
name <file-id> is 
successfully loaded. 


Normal operation. File with 
name <file-id> is 
successfully dumped. 


Specified file is not loaded. 
The reason is given in the 
second message displayed. 


displayed to find the reason. 
None. 


None. 


None. 


Look for the reason in the 


second message displayed by the 


utility. 
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Message 
<file-id> NOT DUMPED 


<family> NOT LOADED 


<family> NOT DUMPED 


— ASSOCIATED DATAFILE 
<file-id> NOT FOUND 


—~INCONSISTENT FILE 
SIZE AT DUMP TIME 


— FILE HAS BEEN 
REMOVED 


~ FILE IS OPEN SHARED 
OR FOR OUTPUT USE 


— FILE HAS BEEN 
ALTERED 


~FILE HAS NOT BEEN 
UPDATED 


— HARDWARE ERROR 
DETECTED WHILE 
READING PSEUDO-PACK 
TABLE ON <disk-id> 


— REQUESTED FILES 
WERE NOT FOUND 


~ HARDWARE ERROR 
DETECTED WHILE 
READING DISK <disk-id> 


—FILE IS ALREADY ON 
DISK 
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(continued) 
Possible Causes 


Specified file is not loaded. 
The reason is given in the 
second message. 


Specified family is not 
loaded. The reason is given 
in the second message 
displayed. 


Specified family is not 
loaded. The reason is given 
in the second message 
displayed. 


The <BOTH> option was 
used but the datafile of an 
indexed pair cannot be 
found. The keyfile is not 
DUMPed. 


DFH file-size and number 
of records DUMPed or 
LOADed are not equal. 


The utility is unable to 
dump the file while it is 
removed. 


Another program is using 
the specified file. 


The file specifications have 
been changed since the 
utility was started. 


The UPDATED option is 
specified for a file which 
has not been updated. 


The utility has encountered 
a read error on the PPIT of 
the input disk. 


the specified files are not in 
the directory of the specified 
disk. 


The utility has encountered 
a read error on the input 

disk. If the utility continues 
it has been able to recover. 


The specified filename 
already exists in the 
directory of the disk. 


Suggested Action 


Look for the reason in the 
second message displayed by the 
utility. 


Look for the reason in the 
second message displayed. 


Look for the reason in the 
second message displayed. 


Check the input disk for the 
presence of the specified files. 
Re-run the utility. 


Investigate discrepancy and re-run 
the utility. 


Check status of files not dumped 
and re-run the utility. 


Wait for the file to be released 
by the program. 
Check status of file not dumped 


and re-run the utility. 


Check status of file not dumped. 


None. 


Check initiating message for 
correct filenames. 


None. 


None. 


rn 


Message 


—ASSOCIATED DATAFILE 
IS ON ANOTHER DISK 


—FILE WAS NOT 
SUCCESSFULLY DUMPED 


INCORRECT INPUT TO LD 


—INVALID CHARACTER 
IN <identifier > 


—FILE NAME <file-id> 
EXCEEDS 12 
CHARACTERS 


— <specified option> IS 
NOT A VALID OPTION. 


—NO FILE NAME 
SPECIFIED 


—~CANNOT HANDLE A 
REQUEST OF THIS 
LENGTH 


—FROM/TO EXPECTED 


—DISK NAME <disk-id> 
EXCEEDS 7 CHARACTERS 


—OPTION <specified 
option> HAS BEEN 
SPECIFIED MORE THAN 
ONCE FOR FILE <file-id> 


—OPTION <specified 
option> HAS BEEN 
SPECIFIED MORE THAN 
ONCE FOR FILE <family- 
id > 
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(continued) 
Possible Causes 


The datafile of an indexed 
pair is not on the specified 
disk. The utility will 
continue but the keyfile is 
not LOADed. 


The specified file is not 
dumped because the file is 
changed or moved since the 
start of the utility. 


There is an error in the 
initiating message. The 
explanation is given in the 
second message displayed. 


One of the characters is 
outside the range A to Z, 0 
to 9, eu or ere de 


The specified filename is 
more than 12 characters 
long. 


The UPDATED option is 
used in the initiating 
message for LOADing or 
ADDing. 

There is no file name 
specified in the initiating 
message. 


The input message exceeds 
601 characters. 


The utility expects the word 
FROM when ADDing or 
LOADing. 


The diskname <disk-id> in 
the initiating message is too 
long. 


At least one of the options 
occurs more than once in 
the initiating message. 


At least one of the options 
occurs more than once in 
the initiating message. 


Suggesied Aciion 


Check the initiating message and 
print the back-up disk directory. 


Check file status and re-run the 
utility. 


Look for the expianation in the 
second error message given by the 
utility. 


Correct input and re-enter. 


Correct input and re-enter. 


Correct input and re-enter. 


Correct input and re-enter. 


Correct input and re-enter. 


Correct input and re-enter. 


Correct input and re-enter. 


Check input and correct. 


Check input and re-enter. 
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ee 


Message 


—FILE IS CURRENTLY 
BEING USED BY 
ANOTHER PROGRAM 


<file-id> REMOVED 


—NO FILES TO <DUMP/ 
LOAD> 


-—LD CANNOT HANDLE 
MORE THAN 2804 FILES, 
LIMIT REACHED AT FILE 
< file-id > 


—FAMILY MAY BE 
INCOMPLETE 


—FAMILY FOR <family- 
name> MAY BE 
INCOMPLETE 


TAPE <tape-id> SHOULD 
HAVE BEEN PURGED 


—PARAMETER 
FOLLOWING KEYWORD 
<string> IS INVALID 


THE UTILITY HAS 
ATTEMPTED TO ISSUE A 
NON-IMPLEMENTED 
COMMUNICATE 


—<tapename> IS NO 
LONGER A VALID LOAD/ 
DUMP TAPE, AND 
SHOULD BE PURGED 


~ FILE IS INCOMPLETE 


ZIP FAILURE WHEN 
ZIPPING CHECKADUMP 
FROM LD 


—PLEASE ENTER Y TO 
RETRY THE ZIP OR N TO 
TERMINATE 
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(continued) 
Possible Causes 


The specified file is not 
available because another 
program is using it. 


The utility has found a 
duplicate filename during a 
LOAD or removes the file © 
as a result of an UNLOAD. 


None of the files specified 
in the initiating message is 
suitable for DUMPing or 

LOADing. 


A request was made to 
DUMP or LOAD more than 
2804 files. 


Part of the requested files is 
on a pseudo-disk pertaining 
to a physical disk which is 
not ready. 


Part of the requested files is 
on a pseudo-disk pertaining 
to a physical disk which is 
not ready. 


The information on the tape 
is such that LD cannot 
handle it. 


The utility has encountered 
an error in the initiating 
message. 


There is a mismatch between 
the MCP and the LD 
utility. 


The utility has encountered 
a parity error on the 
specified tape. 


The specified file is a part 
of a dual pack file. 


LD has tried to zip a 
checkadump as & CHECK 
was specified in the 
initiating message. 


Self-explanatory. 


Suggested Action 
Wait until the other program has 
finished, then re-enter. 


None. 


Check input and re-enter. 


Check input and divide the files 
to be loaded or dumped into two 
groups. 


Ready the disk and re-enter. 


Ready the disk and re-enter. 


Recreate a dumptape after 
purging the tape. 


Correct input and re-enter. 


Copy both MCP and LD utility 
from a good backup disk. Re- 
enter. 


Replace medium. 


Make the other part available and 
re-enter. 


Make CHECKADUMP available 
and enter Y. 


Enter y or N using the AX 
command. 


LF (Look Forward in Log) 
(a function of SYS-SUPERUTL) 

This function will look forward to continue recall in the direction of later messages with a screenful 
of messages. If the serial printer (SPA) is used as the console, then the function will display a number 


of messages calculated by the length of the messages and the width of the console. 


This function may be terminated by entering ‘“LF END”’ causing “END LF’’ to be displayed in re- 
sponse. 


END —— 
LF ee eee ees 


Example: 

To look forward from last recall and display messages: 
LF 

LF can be initiated only after IR, LB, and LF. 

Output Messages 


For output messages refer to LB command. 
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LIST (File List) 


This utility allows the operator to list, in whole or in part, files on any CMS device. Output will be 
either to the line printer or to the console printer. 


LIST will attempt to open SYSMEM on all PPIT listed units for directory scanning. It will check the 
PPIT entry for System Pseudo disk-name. 


See figure 4-5 for railroad diagram of LIST. 

If the ‘‘A’’ option is chosen, the file will be listed in alpha characters. The ‘‘N”’ option will list the 
file entirely in hexadecimal. If neither the ‘“‘A’’ nor ‘‘N’’ options IS selected, the file will be listed 
in both alpha and hexadecimal. 

If the file to be listed is a keyfile, the utility will list the associated data file in the order of the keyfile 
unless the <KEY> option is specified. When the <KEY> option is used, the utility will list the key- 
file itself. 


The operator may also list selected parts of a file by specifying the relative record number at which 
printing should begin and the number of records to be printed from that point. 


Examples: 
To list the records of a file called PROGSRC as alpha: 
LIST PROGSRC A 
To print the first record only of a file called PR200 in hexadecimal: 
LIST PR200 N 1 1 
To list records 100 through 149 of PROGSRC as alpha: 
LIST PROGSRC A 100 50 
To list keyfiles: 
Assume there is a keyfile called PR200K which refers to a data file called PR200. 
The statement 
LIST PR200K N <KEY> will list all the records of the keyfile PR200K in hexadecimal. 
The statement 
LIST PR200K N will list all records of the data file, PR200 in keyfile order in hexadecimal. 
Additional Capabilities 
Non Disk Files 
Files on media other than disk may be listed. Abbreviations for valid devices are as follows: 


MTP — magnetic tape or cassette CRD — punched cards 
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* < file-name > 


—— LIST | 
| | < r-spec > 
< f-spec > 


<f-spec > is defined as : 


SHARED 


< file-name > 
EBCDIC 
RECORD 
BLOCK 
TAPE.MARKS 
NO.LABEL 

1 <KEY > 
<r-spec > is defined as : 


< r-count > 
< record-key > 
< record-key > 


Figure 4-5. Railroad Chart for LIST Utility 
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Examples: 


To list a cardfile called PRFILE in alpha: 


LIST PRFILE CRD A 


To list the first 10 records of a CMS labelled magnetic tape called PRTAPE: 


LIST PRTAPE MTP 1 10 


(Note: this assumes record size of 180 bytes.) The tape or cassette to be listed should be a tape created 
by the COPY utility. Library tapes and non-CMS tapes should be treated as unlabelled (see below). 


Unlabelled Tapes 
Input tapes having no CMS labels (‘‘unlabelled’’ tapes) may be accessed by the LIST utility. 


The NO.LABEL option allows the listing of unlabelled files. On recognizing an unlabelled file, the 
MCP will print a ‘‘DEVICE REQUIRED” message. The operator must then respond with an appropri- 
ate “‘AD’’ input message (see ‘‘AD’’) to identify the unlabelled file. 


The end of file recognition for unlabelled files is determined by tapemark count. The TAPE.MARKS 
option allows the operator to specify the total number of tapemarks which will indicate end of file 
to the utility when listing an unlabelled file. The default value is 2. Each tape mark which is encoun- 
tered will contribute to this total. Therefore, a standard labelled CMS file will be listed up to, but 
excluding, the trailing label if NO.LABEL and 2 tapemarks are specified. (A labelled CMS file consists 
of “label, tape mark, data, tape mark, label’’.) The operator must be aware of the format of any 
file which is to be listed when using the NO.LABEL option. 


If the RECORD size is not 180 bytes, refer to the section on Record/Block modifications. 


Example: 


To list the first file of a magnetic tape with non-standard label (the format being: label, tapemark, 
data, tapemark): 


LIST TP MTP NO.LABEL TAPE.MARKS 2 


Note: MCP will issue a message asking for unlabelled tape TP. Operator must respond with ‘“‘AD”’ 
input. Additionally, the first line of the listing contains a list of the non-standard label. 


Record and Block Sizes 

The listing is record-oriented. The following record sizes are assumed: 
Disk = (Disk File Header) from file itself 

Labelled tape/cassette = from tape label 

Unlabelled tape = 180 bytes 

Cards = 80 or 96 bytes depending on device. 


If different values are required, Record and Block sizes may be specified. 
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Example: 
To list an unlabelled tape containing 10-byte records with 10 records per block: 


LIST TP MTP NO.LABEL TAPEMARKS 2 
RECORD 100 BLOCK 1000 


If EBCDIC is specified, the input will be translated from EBCDIC coding, otherwise ASCII is as- 
sumed. 


For magnetic tape or cassette files the record size must be specified if it is greater than 1024 characters, 
otherwise the utility will not be able to read this file and therefore no list will be produced. If the 
record size is specified and no block size is specified then the block size will be set to the same as 
the record size. For uniabelied files the defauit record and biock sizes are i180 each. 


Note: Care should be taken to ensure that the record and block sizes specified are compatible with 
the physical block size on the tape. The block size specified must be an integer multiple of the record 
size. The utility will attempt to identify inconsistencies when using labelled CMS files. Any inconsi- 
stency not isolated by the LIST will cause MCP to discontinue (DS/DP) the utility. 


Selected File List 


More than one selected portion of the input file may be listed. Pairs of numbers may be specified 
within each pair. The first number specifies a relative record number and the second specifies the num- 


Lon monn 


ber of records to be listed. if an extra number is specified, the lasi number specifies listing from that 
record to the end of file. 


Example: 
To list records 100 to 149, 300 to 499, and 1000 to end of file. 


LIST FILE1 100 50 300 200 1000 
Selected Indexed File List 


For indexed files, listing or records can be selected based on content of the key. There are two options: 
the number of records can be specified or an ending key value can be given. 


Examples: 


PQR is a keyfile containing personnel records. To list 15 records from the corresponding data file start- 
ing from the record with personnel number 01786: 


LIST PQR 01786 15 
Using the same keyfile to list all data records from personnel number 01786 to 18000: 
LIST PQR 01786 — 18000 


Note: the second option is specified by the hyphen in the LIST statement. Note that at least one space 
is required before and after all key values (personnel numbers in this case). 


Note: when using this option to list from a specified key to another specified key, care must be taken 
to enter the whole key value including leading zeros. In the case of an incomplete key, the data Is 


left justified and space filled on the right. 
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Output Messages 


Message 
<filename> NOT LISTED 


-~NO RECORDS TO LIST 


— INVALID FILE 
SPECIFICATION FOR 
< filename > 


— FILE IS CURRENTLY 
USED BY ANOTHER 
PROGRAM 


— RECORD SIZE 
EXCEEDS MAXIMUM SET 


a 


FOR THIS RUN, PLEASE 
RESUBMIT 


— NO RECORDS IN 
KEYFILE <file-name> 


— KEYFILE OR DATAFILE 
IS CURRENTLY BEING 
USED BY ANOTHER 
PROGRAM. 


— KEYFILE OR DATAFILE 
NOT FOUND 


— KEYFILE OR DATAFILE 
IS ON A DISK WHICH IS 
CURRENTLY LOCKED BY 
ANOTHER PROGRAM 


— ASSOCIATED 
DATAFILE < file-name> 
NOT FOUND 


— HARDWARE ERROR 
DETECTED WHILE 
READING KEY <key> 
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Possible Causes 


The utility could not list the 
specified file. The reason is 
given in the second message 
displayed. 


The specified file is empty 


The specification, or 
combination of specifications 
given is not permitted. 


The specified file is in use by 
another program. 


LIST has encountered a file 
with a record size greater 
than expected. This can 
happen if a magnetic tape file 
with record size greater than 
1024 chararcters is submitted 
to the utility without the 
record size being properly 
specified in the initial input. 


<BOTH> option was used. 
Utility was not able to access 
data file through some failure 
in the keyfile. 


Another program has opened 
the file for output use. 


Specified file is not in the 
directory of the specified disk. 


Specified keyfile or datafile is 
on a disk whose SYSMEM is 
opened with lock-access by 
another program 


The datafile which belongs to 
the specified keyfile is not on 
line. 


Error encountered when 
reading specified key. 


Suggested Action 


See explanation for the error in 
the second error message 
displayed by the utility. 


Check input for correct 
filename. 


Check input for correct 
specifications. 


Use ‘SSHARED”’ or ‘‘FREE”’ 
option to list the file. 


Check input for correct record 
size. 


Check input for correct syntax 
or use SORT to create a new 
keyfile. 


Use ‘‘FREE”’ or ‘“‘SSHARED”’ 

option in initiating message if 

other program is not using the 
file with LOCK-ACCESS. 


Check input for correct disk and 
filenames. 


Wait until the other program 
has finished and re-enter. 


Bring associated datafile on line 
and re-enter. 


Check datafile for errors or use 
““RECOVER”’ for copying the 
readable records. Then LIST 
again. 


Message 


— HARDWARE ERROR 
DETECTED WHILE 
READING RECORD 
<record number > 


— FILE IS NOTA 
SOURCE OR DATA FILE 


— PRINTER BACKUP FILE 
<filename> NEEDS TO BE 
INCREASED 


— FILE IS NOT AN 
EBCDIC FILE 


FAMILY MAY BE 
INCOMPLETE 


FAMILY FOR LIST MAY 
BE INCOMPLETE 


END OF FILE REACHED 
ON <file-name> DURING 
RANGE FROM RECORD 
<record-number > 


END OF FILE REACHED 
ON <file-name> DURING 
RANGE FROM KEY <key> 


<filename> RANGE FROM 
RECORD <record-number > 

IGNORED SINCE OUT OF 

SEQUENCE 


<filename> RANGE FROM 
RECORD <record-number > 

IGNORED SINCE BEYOND 

END OF FILE 


—RECORD SIZE LIMIT IS 
10000 


(continued) 
Possible Causes 


Error encountered when 
reading specified record. 


A file has been specified for 
listing with translation to 
EBCDIC which is not source 
or data type. 


LIST was printing the printer 
backup but the filesize of the 
PB file is too small. 


A disk file has been specified 
for translation from EBCDIC 
which is not an EBCDIC data 
type file. 


A family is specified for 
listing from a unrestricted 
pseudo-disk and at least one 
of the physical disks is not 
available. 


A family is specified for list 
from an unrestricted pseudo- 
disk and at least one of the 
physical disks is not available. 


End-of-file encountered while 
section of file indicated by 
record-number is being listed. 


End-of-file encountered while 
section of the file indicated 
by key is being listed. 


A non-disk file or null-key 
keyfile is being listed with 
record selection, the selected 
ranges must be in sequential 
order. 


Once the end of a null-key 
keyfile or a non-disk file is 
reached, no further selections 
can be listed. 


The utility cannot handle 
record sizes greater than 
10000. 


Suggested Aciion 


Check datafile for errors or use 
“RECOVER”? for copying the 
readable records. Then LIST 


again 
None 


Use SO PRBK <number> to 
increase the PB filesize. 


None. 


None. 


None. 


None. 


None. 


None. 


None. 


None 


Note: Refer to ‘“‘Common Utility Output Messages’’ for additional aid. 
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. Utility limit. 
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LOAD (LD — TAPE LIBRARY UTILITY) 


This function is part of the utility LD.LOAD. It provides the capability of copying files or groups 
of files and removing duplicate files from the disk, if present, from a library tape to the disk specified 
by disk-name or, if no disk-name is specified, to the system disk. 


om eee ce LOAD & CHECK PRINT.DIR "FROM —— <tape-name > ——> 


< file-name > 


< disk-name > <BOTH > 
< family-name > 
& CHECK If & CHECK is specified, CHECKADUMP will be zipped 
(without pause or display) from LD when the LOAD is 
complete. 
PRINT.DIR If PRINT.DIR is specified, a printout of all the files 


loaded will be produced at the end of the LOAD. 
When PRINT.DIR is specified, the messages 


‘‘< file-name> REMOVED” 
‘‘< file-name> LOADED’’ 


will be suppressed. 
Displays will be limited to exception conditions, that is, if 
a file is not loaded for some reason. 


FROM <tape-name> This is the name of the tape from which the files are to 
be loaded. 
TO <disk-name> If the TO option is specified, the name of the disk to 


which the files are to be loaded must be given. If the TO 
option is not used, then the files are loaded onto the 
system disk. 


<file-name> <family-name> This is the file or family of files to be loaded onto the 
disk. Groups of files may be loaded by separating the file 
names or family names by a comma ‘‘,’’. 


<BOTH> If <BOTH> is specified immediately following a request 
to load a key file then, provided that the pertinent data 
file does not precede the key file on the library tape, the 
data file will also be loaded and a suitable amendment will 
be made to the key file so that it points to the disk which 
now holds the data file (rather than the disk from which 
the data file was dumped). 


Since the LOAD function is part of the utility LD, ““LD’’ appears in a mix message. To discontinue 
the LOAD function, ‘(DS <mix-number>/LD’’ must be used. 
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Examples: 


Example 1. 


Example 2. 


Example 3. 


Output Messages 


To copy all the files from the tape named UPDATE to the system disk, 
the following syntax is used: 


LD LOAD & CHECK FROM UPDATE = 


With the addition of the keyword ‘‘& CHECK’’, the LD utility will zip 
the utility CHECKADUMP after all the files have been loaded. 


LD LOAD & CHECK FROM UPDATE = 


To copy the keyfile named QUARCK and its associated data file from the 
tape called QACK to the disk called Q3, the following syntax is used: 


LD LOAD FROM QACK TO Q3 QUARCK <BOTH> 


To copy all the files from the tape called BACKUP in the family JOB. to 
the disk named DISK1, the following initiating message is used: 


LD LOAD PRINT.DIR FROM BACKUP TO DISK! JOB.= 


With the addition of the option PRINT.DIR, a printout of all the files 
which LOAD loaded will be produced. 


For output messages refer to LD utility. 
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LOAD.VFU (Load Vertical Format Unit — B 90/B 900 Only) 


This utility allows the operator to define the page format on a line printer that contains a soft vertical 
format unit. 


NOTE 
LOAD.VFU cannot be used on B 9252 line printers as it expects input in a 
format that is incompatible with B 9252. 
The utility has 4 possible formats: 


Format for DEFINE: 


LOAD.VFU ——— DEFINE ——— < format.name > === < page.height > Ae 2—— <end.of.page > mie 
2 <channel> = <skip.to.line > 


Format for FORMAT: 


LOAD.VFU FORMAT <printer.device > ————» WITH ———._ < format.name > —— 


Format for LIST: 


LOAD.VFU — es ALL iad < format name > aks 


Format for DELETE: 


LOAD.VFU—— DELETE ——— <format.name > ——J 


The utility may be used to define vertical format unit formats and store them in a library file SYSVFU- 
-LIB. These formats can be subsequently selected by name to be loaded to the specified printer (type 
A 9249-30/50 or B 9251-1). The utility zips the VF intrinsic which performs the actual loading of a 
format string. 


Define 


The define format is used to enter a format in a library file called SYSVFU.LIB. If this file does not 
exist on the system disk, it will be created. 


The FORMAT.NAME you want to create must have a unique name. If the name already exists in 
the SYSVFU.LIB file, the utility will give an error message. 


The PAGE.HEIGHT is the maximum number of lines which can be printed on the selected form to 
be formatted. (for example, 66 lines on 11 inch pinfeed). 
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The END.OF.PAGE is the last line on the selected form on which printing is allowed. So, to stop 
six lines from the bottom on a 66 lines high form, enter 60. 


The CHANNEL is a number from 2 to 11 which corresponds to the channel number given in a write 
statement in an application program. 


The SKIP.TO.LINE indicates the print line corresponding to the channel to which the printer has to 
skip if a write statement with a channel option is executed. 


For example, LOAD.VFU DEFINE LP.PAYROLL.FORM 66, 60, 2 10, 4 20 
Format 


The FORMAT format is used to load a format formerly defined in the SYSVFU.LIB file to a specific 
printer. 


For PRINTER.DEVICE you have to enter a device mnemonic, for example, LPA. The FORMAT- 
NAME is the name formerly defined in the SYSVFU.LIB file. 


For example, LOAD.VFU FORMAT LPA WITH LP.PAYROLL.FORM 


‘ 
List 
The LIST format is used to Hst one or all of the formats defined in the SYSVFU.LIB file. 


For example: 
LOAD.VFU LIST ALL 
LOAD.VFU LIST LP.PAYROLL.FORM 


Delete 

The DELETE format is used to delete a format defined in the SYSVFU.LIB file. 
For example, LOAD.VFU DELETE LP.PAYROLL.FORM 

Limitations 

The utility does not check the following: 


1. For each channel, no more than four line numbers can be specified. 
2. Page height defined should not be greater than 94 lines. 


The FORMAT function allows the operator to load a predefined VFU format to a specified printer. 
The printer must be ON LINE and NOT IN USE. 


Note 
The default values of page height and end of page are 66 and 60 respectively. 
Non-default values require that the format should be loaded prior to the 
execution of the program. 
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Output Messages 


Message 


INCORRECT INPUT TO 
LOAD.VFU : <input> 


PRINTER LPx NOT 
FORMATTED WITH 
< format > 


<format> NOT DEFINED 


<format> NOT LISTED 
<format> NOT DELETED 


—SYSVFU.LIB IS NOT A 
RECOGNIZED SYSTEM 
FILE 


CANNOT ACCESS 
SYSVFU.LIB 


—~FILE NOT FOUND 


—FILE IS CURRENTLY 
BEING USED BY 
ANOTHER PROGRAM 


— HARDWARE ERROR 
DETECTED WHILE 
READING SYSVFU.LIB 


—HARDWARE ERROR 
DETECTED WHILE 
WRITING TO SYSVFU.LIB 


— <format> NOT DEFINED 
IN SYSVFU.LIB 


— <format> DEFINED IN 
SYSVFU.LIB 


— <format> DELETED 
FROM SYSVFU.LIB 


SYSVFU.LIB REMOVED 
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Possible Cause 
Typing error in initiating 
message. 

FORMAT function of 
LOAD.VFU was not 
successful. 

DEFINE function of 
LOAD.VFU was not 
successful. 


LIST function of 
LOAD.VFU not successful. 


DELETE function of 
LOAD.VFU not successful. 


The filetype of the 
SYSVFU.LIB file is wrong. 


LOAD.VFU cannot open the 
SYSVFU.LIB file. 

A FORMAT, LIST or 
DELETE function was 


specified but there is no 
SYSVFU.LIB file on disk. 


Self-explanatory. 


The utility has found an 
error on the SYSVFU.LIB 
file. 


The utility has detected an 
error while adding a new 
format to the file. 


Self-explanatory. 


LOAD.VFU DEFINE was 
successful. 


LOAD.VFU DELETE was 
successful. 


LOAD.VFU DELETE was 
successful on the only 
format in the file. 


Suggested Action 
Correct input and re-enter. 


Look at the second error message 
given to find the reason. 


Look at the second error message 
given to find the reason. 


Look at the second error message 
given to find the reason. 


Look at the second message given 
to find the reason. 


and create a new one using the 
DEFINE option, or copy a good 
version SYSVFU.LIB from 
backup disk. 


Look at the second message given 
to find the reason. 


Make SYSVFU.LIB file available 
or create one using the DEFINE 
option. 


Wait until the other program 
stops using the SYSVFU.LIB file. 


Check integrity of the disk. 


Check integrity of the disk. 


Check input for correct format 
name or use DEFINE option to 
create the requested format. 


None. 


None. 


None. 


(continued) 


Message Possible Cause Suggested Action 

PRINTER LPx LOAD.VFU FORMAT was None. 

FORMATTED WITH successful. 

< format > 

END LOAD.VFU Normal end-of-job. None. 

Note 
For details of the VF intrinsic see section 3. 
2032801 
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LR (List Directory) 


This utility allows the operator to display, on the printer or the SPO, detailed information about partic- 
ular files or groups of files on disk. For each file n the family, if <file-name> is specified, an output 
line is generated. The overflow pack-id of a dual-pack file will be listed with the size of each area 
which is on the overflow-pack or on an extra line, if none. 


Format: 


SAS 
< ASCENDING > 


< disk-id >/ 


< filename > 


LR < group-name > 


If a file has areas on an associated overflow disk, the disk name of the overflow disk is printed beside 
each relevant area address and size. Note that the addresses for the areas on an overflow disk are not 
necessarily correct. 


If a particular file or group is not found on a specified disk, this is indicated on the listing. 


If ‘‘<ASCENDING>”’ or ‘‘<A>”? is selected, the utility will print the information requested in as- 
cending order of filenames. If more filenames or groupnames are in the initiating message and the as- 
cending option is specified once, all the files are printed in ascending order. 


If <integer> is specified after the LR of an entire disk (that is, LR ARDISK2/), then LR will only 
print information about those files whose total number of sectors allocated is greater than <integer>; 
this will be followed by a listing, with totals, of all available and temporary areas on the disk. This 
feature is only permitted for physical disks, not pseudo packs. 


If “<DISPLAY >” or“< D>” is specified, then the utility will list the information on the SPO. The 
output format is designed for a 24 line by 80 character screen. 


NOTE 
The <integer> option described above is not intended for use with the 
< DISPLAY > option. 


An output line concerning a keyfile will normally be followed by a second line showing the name of 
the data file to which the keyfile points and the key offset and length. 


The heading lines printed at the top of each page will provide a good deal of information about the 
disk itself. 


When handling Pseudo-pack disks, the utility will attempt to open SYSMEM on all PPIT listed units 
for directory scanning and will search for a PPIT entry with a tag of 20 for system Pseudo disk-name. 


Examples: 
To print the entire directory of the system disk: 
LR = 


To print the entire directory of ARDISK2 in ascending order: 
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LR ARDISK2/= <A> 


To print information about the file called ‘“AR200” and a group of files beginning with the letter ‘‘C”’ 
only: 


LR C=, AR200 


To print information only about files on the system disk which have been allocated greater than 1000 
sectors: 


Output Format 


LR displays in its page heading the type and version number of the bootstrap residing on the disk 
being analyzed. The format is: 


<bootstrap type> DISK 


where <bootstrap type> is detailed in the following table: 


Bootstrap Type Disk Type System Initialized On 
CMS/WARMSTART Removable disks only B 90 
B 900SYSTEM Removabie disks only B 900 
MTR Removable disks only B 90/B 900 
CMS/WARMSTART&MTR Fixed disks only B 90 
B 900SYSTEM&MTR Fixed disks and packs B 900 
COLDSTART BSMII Mini 1MB Mini B 90 


The bootstrap version number will be displayed if the bootstrap located in track zero, of the disk being 
analyzed, contains its own version number and correct checkstring. The bootstrap version number ap- 
pears following the bootstrap type in the following format: 

BOOTSTRAP VERSION dd.dd.dd 


Fourteen columns of information will be output to the printer for each disk for which information 
is requested. The column headings, the format of the values these columns contain, and the significance 
of these values are as follows: 


Heading Value Significance 

FILE NAME 12 characters File name. 

ACTUAL SIZE 7 digits Number of records currently 
contained in file. 

MAXIMUM SIZE 7 digits Maximum number of records 
which file may contain. 

RECORD SIZE 5 digits Number of bytes per record. 

RECORDS BLOCK 5 digits Number of records in each 
block. 

CREATED 5 digits File creation date (Julian 
YYDDD). 
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(continued) 


Heading Value Significance 

ACCESSED 5 digits Last access date (Julian 
YYDDD). 

UPDATED 1 character Flags files which have been 
updated. See note 1. 

GEN. NO. 3 digits 

FILE TYPE 7 characters, 2 hex characters See note 2. 

VERSION NO. 6 digits See note 3. 

NO. AREAS 2 digits Number of areas currently 
allocated. 

AREA LOCATIONS 8 digits, 6 hex characters, 7 See note 4. 

characters 
AREA SIZES 8 digits, 6 hex characters See Note 4. 


Note 1. If a file which is being listed has been updated, the letter ‘‘U’’ will be printed on the same 
line as the file name in the column called UPDATE. The utility identifies that the file has been updated 
by checking the update flag in the file. The following utilities reset this update flag: LD, CHECKA- 
DUMP if zipped by LD and DUMPADISK if the dumps are successful. 


Note 2. The actual filetype of each file is is displayed with type identifiers. 


Note 3. A VERSION NUMBER FIELD is included in the output line for a file. If the file is an S- 
CODE file, then: 
1. If it is a new S-CODE file and a version number is present in its Program Parameter Block 
(that is, the source file used to produce the S-CODE file contained the dollar option ‘‘$ VER- 
SION dd.dd.dd’’ where d is a decimal digit), the version number field will contain the version 
number in the Program Parameter Block, in the format dd.dd.dd. 
2. If it is an old S-CODE file or no version number is present in its Program Parameter Block, 
then the version number field will contain ‘‘...... wae 
If the file is not an S-CODE file, then the version number field will contain spaces. 


Note 4. For each file the area addresses and sizes of allocated areas will be printed in these columns. 
For areas on an overflow disk the overflow disk name will follow the area location. 


Note 5. If an LR listing of a disk created by DUMPADISK is empty, use PRINT.DIR. 


Output Messages 


Message Possible Causes Suggested Action 


<filename> NOT LISTED 


FAMILY <familyname> 
NOT LISTED 
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The utility has not listed the 
specified file. The reason is 
given in the second message 
displayed. 


The utility has not listed the 
specified family. The reason is 
given in the second message 
displayed. 


Look at second error message 
given by utility to find the 
reason. 


See second error message given 
for the reason. 


Message Possible Cause 


—~LR CANNOT HANDLE LR cannot handle more than 
THIS NUMBER OF 2804 entries. 
DIRECTORY ENTRIES 
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Suggested Action 


Specify family names to list 


parts of the disk. 
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MODIFY 


This utility allows the changing of a number of file attributes within the file parameter block (FPB) 
and program attributes within the program parameter block (PPB) of a code file. It should not be 
used unless the meaning of each attribute is thoroughly understood. Refer to the CMS MCP manual 
for more information on FPB and PPB formats. 


The utility operates in an interactive manner using a console file or a datacomm terminal if no further 
information is provided when initiating the utility, thus: 


Using console: MODIFY 
Using datacomm: <control char> RN MODIFY 


For details of the interactive mode, see later. Specifications can be entered when starting the utility. 
The name of the code file to be modified is preceded by the keyword ‘“CODE.FILE’’. The word ‘‘CO- 
DE.FILE”’ can be omitted from the first element of the initiating message. Following the code file 
name is either the keyword ‘‘FILE”’ to enable file attributes to be modified, or the keyword ‘‘PPB”’ 
to enable program attributes to be changed. The file whose attributes are to be changed is specified 
by the internal file name (i-f-n) as given by the program source code listing. The i-f-n is determined 
by the programmer. Additional keywords are ‘‘PRINT.FPB’’ and ‘‘PRINT.PPB”’ to print the complete 
FPB and PPB respectively. The complete specifications to the utility are terminated by the keyword 
‘“SEND’’. 


Format 


MODIFY CODE.FILE RTE < file-name > — < modify-options > --, END 
< disk-name > / 


where < modify options > 


< file-attribute > — < file-attribute value > 


FILE — < jnternal-file-name > 


PRINT.FPB 


< ppb-attribute >--< ppb attribute value > 
PPB 


PRINT.PPB 


The commas are optional, but may be used to improve readability. See later for the list of attributes 
and allowable values. 


When a PPB is being printed, MODIFY checks the release level of the code file, printing the S-LAN- 
GUAGE for pre-3.3, and MCP level and HARDWARE type for post-3.2. It should be noted that the 
MCP level printed for certain released code files is not that of the host system MCP, but that of the 
system on which the code files were compiled. 


If an unknown machine type is encountered, ‘‘UNKNOWN?”’ is printed. 
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The PPB version field (bytes 21-23) will be printed if the priority extension bit (BIT 12) is set. The 
version will be shown as DD.DD.DD where D is a decimal digit. 


The HARDWARE type is indicated as follows: 


Byte Value Type 
1 —- 10 B 80, B 90 
11 — 20 B 776 
21 — 30 B 800 
31 — 40 B 900 
41 — 50 B 1700 
51 -— 60 B 1800 


The second byte of the field in the PPB is machine-dependent and is therefore not printed. 
Examples 
To modify the value of FID (file-id) and change the device kind of a file whose internal name is IN- 
FILE in a program code file COPY on disk SYS2: 

MODIFY CODE.FILE SYS2/COPY, FILE INFILE FID CARDS DEVICE CR, END 


To change the value of CONTROL.STACK to 50 in code file AR768 on disk AR1, and print the result- 
so MODIFY ARI/AR768 CONTROL.STACK 50 PRINT.PPB END 

Interactive Mode 

Console Operation 


If no initiating specifications are given, PKs 1 to 6 are lit for various functions. 


PK1 PK2 PK3 PK4 PK5 PK6 
help modify PPB modify FPB specify code print FPB or END 
file PPB 


Pressing PK1 gives a display of the meanings of the six PKs, as shown above, followed by the request 
CODE.FILE? 


Enter the code file name, followed by OCK1. The utility requests 
SELECT FUNCTION 


and lights appropriate PKs. While any relevant PK is lit, the corresponding function can be started. 


If PK2 (modify PPB) or PK3 (modify FPB) is pressed, the utility requests 
PPB ATTRIBUTE or 
FPB ATTRIBUTE 


Enter the name of the attribute, as given in table 4-6. The utility displays the current value, then re- 
quests 
NEW VALUE 


Enter the new value required. The utility then returns to the select function loop. 
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Datacomm Operation 


If MODIFY is given a datacomm start (for example, $RN MODIFY) any initiating message is ignored. 
The terminal must be known to the system by a prefix ‘‘TD830’’ and must have TD 830 capabilities. 
MODIFY supports a GEMCOS interface and a shifted TMCS interface. 


The program, once started, is menu-driven. The first screen shows four selectable options: 


1. Terminate the program. 

2. Enquiry/modification of a code file’s program parameter block. 

3. Enquiry/modification of one of a code file’s file parameter block 
4: Enquiry of the filenames in a code file’s internal file name block 


Option 1. 
This option will terminate the program. 
Options 2 and 3 


If either of these options is chosen, the relevant field names and associated data are automatically pres- 
ented on the screen. Any redefinable fields have their data presented between forms characters, so the 
terminal is in forms mode and data which can be changed is in an unprotected field. 


On the bottom of the page there are six options offered to the user: 


fe447" Terminate 

22 SO? Other page 

32-fP?? Print information 

4: §U”’ Update 

5: NUMBER Displays a help screen 
6: BLANK Back to the main menu 


1: eT. 
Terminates the session and displays the termination screen on the users terminal. 


2: “OQ” 
Produces another screen with the rest of the fields which did not fit on the first page. 


Page 1 and page 2 together make up a complete display of either a Program Parameter Block or a 
File Parameter Block. 
3: sp” 
Produces a print of the information presented on the screen. If no line printer is available and 
printer backup is possible, the printer backup filename will be displayed on the status line. 


4: sU”’ 
Will force the utility to update the parameters in the codefile if the updated data in the forms 
fields is valid. 


5: NUMBER 
Displays a help screen for the item whose number is entered. To return to the calling screen press 


XMT. 
6: BLANK 
When nothing is entered the program returns to the main menu without updating any fields. 
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ence acacia oes Sas at a ee, ee 


Option 4 


This option produces a screen with the filenames held in the internal file block of the program name 
entered on the menuscreen. At this point there are five options. 


west Terminate 

2o SO” Other page 

3: **P” Print information 

4: NUMBER Go to FPB analyses for the associated file 
5: BLANK Back to main menu 


1: sey? 
Terminates the session and displays the termination screen on the users terminal. 


2° “oO” 
Produces another screen with the rest of the file names which did not fit on the first page. 


3: sep”? 
Produces a print of the information presented on the screen. If no line printer is available and 
printer backup is possible, the printer backup filename will be displayed on the status line. 


4: NUMBER 
Every filename is associated with a number on the forms screen. Typing in one of these numbers 


Se sat 


forces the program to go directly to the File Parameter Block anaiysis of the specificd file. 


5: BLANK 
When nothing is entered the program returns to the main menu. 


File Attributes — interactive/Non-interactive Analysis 


Table 4-6 gives the keywords for each file attribute that can be changed by the MODIFY utility, togeth- 
er with allowable values for each attribute. Table 4-7 gives the keywords of each PPB attribute that 
can be changed, and allowable values for each. 


Note that each modification is performed in turn, so that the keywords PRINT.FPB and PRINT.PPB 
will reflect the FPB and PPB after any modifications specified previously in the message to MODIFY, 
but before any modifications are made that are specified after the print request. 


Most attributes that require a number may be assigned a hex value by supplying @hh@ where hh is 
a string of characters in the set 0..9, A..F. 


Attributes which require a character representation of a decimal number, for example, REEL, will not 
accept a hex number. 


Output Messages 


Message Possible Cause Suggested Action 
ATTRIBUTE VALUE Value is either missing or Check current values by 
MISSING incorrect; other modifications PRINT.FPB or PRINT.PPB; 

carried out. then use utility for the attribute 
in error. 
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Message 
KEYWORD IN ERROR 


ATTRIBUTE-VAL 
INCONSISTENT 


INCORRECT ATTRIBUTE 


DEVICE ~ MYUSE 
INCONSISTENT 


FILE-SIZE TOO LARGE 


TOO MANY BUFFERS 


REC. NOT INTEGRAL OF 
BUF. 


CODE FILE NAME IN 
ERROR 


FILE NAME NOT FOUND 


CURRENCY SYMBOL 
EXPECTED 


NUMERIC ATTRIBUTE — 
VAL REQD 


FILE NOT SPECIFIED 
PPB NOT SPECIFIED 


NOT AN INDEXED FILE 


NOT A COBOL PROGRAM 
FILE 


NOT AN MPL PROGRAM 
FILE 
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(continued) 
Possible Cause 


Self-explanatory; other 
modifications carried out. 


The attribute being assigned 
cannot take the value being 
given; other modifications 
carried out. 


A value is being assigned to a 
value, rather than to an 
attribute; other modifications 
carried out. 


Incompatible values of these 
file attributes. This is a 
warning that the program 
may give an error when 
executed. 

Value for FILE-SIZE is 
incorrect. This is a warning. 


Value for NO.BUFFERS is 
incorrect. This is a warning. 


The buffer size is not an 
exact multiple of the record 
size. This is a warning. 


Self-explanatory; all 
modifications are ignored. 


The internal file name is not 


in code file; all modifications 
are ignored. 


Self-explanatory 


Non-numeric characters were 
input where a numeric value 
is needed. 


Missing keyword ‘‘FILE”’ 


Attempt to modify PPB while 
not in PPB mode. 


Attempted to use an indexed- 
file attribute on a non-indexed 
file. 


Wrong PPB attribute used 
(see table) 


Wrong PPB attribute used 
(see table) 


Suggested Action 
As above. 


As above. 


As above. 


use MODIFY to correct either 
or both of these fields. 


Check with PRINT.FPB if 
necessary and correct the 
attribute. 

As above. 


Use MODIFY to correct one or 
both of these attributes before 
running program. 

Re-input. 


As above. 


Re-input. 


Check with tables 4-6 and 4-7 
and re-input. 


Re-input. 
Re-input. 


Check initial input to MODIFY 


Re-input. 


Re-input. 


Message 
NOT A PPB ATTRIBUTE 


NOT AN FPB ATTRIBUTE 


CODE FILE — BAD FILE 
TYPE 


CODE FILE IN USE 


CANNOT OPEN THAT 
CODE FILE 


NUMBER TOO BIG 


MUST HAVE 0 < KEY 
LENGTH < 29 


DECIMAL NUMBER 
REQUIRED 

FILETYPE NOT 0-15 OR 
@80@ 

FILE NOT DATA OR INX 
TYPE 


(continued) 
Possible Cause 


Attempted to modify an 


attribute which is not of the 
PPB. 


Attempted to modify an 
attribute which was not of 
the FPB. 


Attempted to modify a code 
file which was not of type 
CODE. 

The specified code file is in 
use. 

Attempted to modify a code 
file which was not available 
for some reason. 


Attempted to assign a value 
greater than 65535. 


Attempted to assign a KEY 
LENGTH value out of range. 


Decimal number required. 


New value of FILETYPE not 
in range. 


Old value of FILETYPE not 
in range. 


Suggested Action 
Check input and re-enter. 


Check input and re-enter. 


None. 


Wait until the task using code 
file goes to End of Job. 
None. 


Re-enter. 


Re-enter. 


Table 4-6. File Attributes Accessible by MODIFY 


File Attribute Name 


BUFFER 
FILESIZE 
NO.BUFFERS 
CYCLE 

FORMS 
SET.UPDATE 
NO.LABEL 
CONDITIONAL 
SINGLEAREA 
GEN.CHECK 
NO.REWIND 
REVERSE.ESCAPE 
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Allowable Values 


1-7 alphanumeric characters 

1-12 alphanumeric characters 

3 decimal digits in range 000-999 

One of the mnemonics given in table 4-8. 
1-5 decimal digits in range 0-65535 

1-5 decimal digits in range 0-65535 

1-7 decimal digits in range 0-1048560 

1-2 decimal digits in range 1-16 

2 decimal digits in range 00-99 


ON, OFF 
ON, OFF 
ON, OFF 
ON, OFF 
ON, OFF 
ON, OFF 
ON, OFF 
ON, OFF 
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a a) 
Table 4-6. File Attributes Accessible by MODIFY 


(continued) 
File Attribute Name Allowable Values 


CLOSEMODE LOCK, PURGE, REMOVE, RELEASE, HALF.CLOSE 
CRUNCH ON, OFF 

MERGE ON, OFF 

OTHERUSE FREE, LOCK.ACCESS, LOCKED or SHARED 
MYUSE INPUT, OUTPUT, IO 

EXTEND ON, OFF 

ACCESSMODE SEQUENTIAL, STREAM, RANDOM 

GEN.NO 1-5 decimal digits in range 0-65535 

LAST.ACCESS 5 decimal digits in Julian date format, YYDDD 

SAVE 1-3 decimal digits in range 0-999 


FILE.DEFAULT 
NON.STANDARD 
D.MFID 

D.FID 
ROUGH.TABLE 


TYPE] thru TYPE29 (see MPL Reference Manual) 
ON, OFF 

1-7 alphanumeric characters (indexed files only) 

1-12 alphanumeric characters (indexed files only) 

1-5 decimal digits in range 0-65535 (indexed files only) 


KEY.LENGTH 1-2 decimal digits in range 1-28 (indexed files only) 

KEY.OFFSET 1-5 decimal digits in range 0-65535 (indexed files only) 

BACKUPPERMITTED DONTCARE, DONTBACKUP or MUSTBACKUP 

CREATENAMEDBACKUP | ON, OFF 

FILETYPE If original value @80@ or 0-15, then new value must be in same 
range. 

USERNAME 1-17 alphanumeric characters or 0 

SECURITY.TYPE PUBLIC/PRIVATE/SECURED 

SECURITY.USE INPUT/OUTPUT/IO 


SECURITY.GUARD.MFID | 1-7 alphanumeric characters 
SECURITY.GUARD.FID 1-12 alphanumeric characters 
HOSTNAME i-i7 alphanumeric characters or ‘“‘ ’’ (blank) 


Table 4-7. PPB Attributes Accessible by MODIFY 


PPB Attribute Name Allowable Values 


INTERP.PACK 1-7 alphanumeric characters 
INTERP.NAME 1-12 alphanumeric characters 
CLASS A, B, C 


EOJ.SUPPRESS ON, OFF 

DATA.STACK 1-5 decimal digits in range 0-65535 (MPL/BIL programs only) 
CONTROL.STACK 1-5 decimal digits in range 0-65535 

CURRENCY.SYMBOL one character (COBOL/RPG programs only) 


Table 4-8. Mnemonics for Device Attribute for MODIFY 


Any printer. 
Keyboard printer. 
Keyboard display. 
Keyboard any output. 
Serial printer. 
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MT9.NRZ 


CS.NRZ 


Table 4-8. Mnemonics for Device Attribute for MODIFY 


(continued) 


Line printer. 

Any card reader. 

Any card punch. 

Any card reader/ punch. 

80-column card reader. 

80-column card punch. 

80-column card reader/punch. 

96-column card reader. 

96-column card punch. 

96-column card reader/punch. 

Magnetic tape reel or cassette. 

Magnetic Tape Reel or cassette without write permit. 
P.E. magnetic tape reel or cassette. 

P.E. magnetic tape reel or cassette. without write permit. 
NRZ magnetic tape reel or cassette. 

NRZ magnetic tape reel or cassette without write permit. 
Magnetic tape reel. 

Magnetic tape reel without write permit. 

P.E. magnetic tape reel. 

P.E, magnetic tape reel without write permit. 

NRZ magnetic tape reel. 

NRZ magnetic tape reel without write permit. 

Magnetic tape cassette. 

Magnetic tape cassette without write permit. 

P.E. magnetic tape cassette. 

P.E. magnetic tape cassette without write permit. 

NRZ magnetic tape cassette. 

NRZ magnetic tape cassette without write permit. 

Any disk. 

Any mini-disk. 

Any Burroughs Standard mini disk. 

BSMII disk. 

Cartridge disk. 

2011 disk. 
211 disk. 
Disk pack. 
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a i nt 
PB (List Printer Backup Files) 


The CMS Printer Backup utility (PB) is an MPLII program which allows files created in accordance 
with the CMS Printer Backup facility to be printed by CMS users. 


The utility has five possible formats: 


Format 1: 


PB PRINT < file- spec > 


> 


(1)—— ON <device_type > 
(1)}—— BEFORE <date> 
(1} —— COPIES < number > 


(1) —— SAVE 
(1) —— FORMS 
Format 2: 
PB PRINT < file > (1}—— ON <device_type > 
PBnnnnn (1) —— COPIES < number > 
nnannn (1) —— SAVE 
(1) —— FORMS 
a PAGE < number> “ 
RECORD < number > 
< number > 
Format 3: 
PB ios re < file.spec > BEFORE <date> 
en Sean eee ee) 
Format 4: 
PB 


AUTO i ON < device.type > ae a 
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Format 5: . 


PB List —————._ < file.spec > (1) —— ON <device.type > 


(1) —— BEFORE < date > 


where < file.spec> is: 


a eae ae seom> 4 
Ji < family > 


PBnnnnn — PBnnnnn 
PBnnnnn 


nnnann 


where < device.type > is: 
eee 
' LP 
a sp 
< station.id > 


AP 300 printers which do require special handling may be identified to PB in one of two ways: 


(< printer type > ) 


1. If their <station.id> is of the form AP300XAxx where xx is any decimal number. 
2: If <printer.type> follows the <station.id> where <printer.type> is (AP300). 


<date> has the format of mm/dd/yy 
where mm = month, dd = day and YY = year. 


<number> is any decimal number. 
PBnnnn stands for a file name in the range PBOO001 through PB99999. 
PB Initiating Message Parameters 


<diskid >/ Identification of disk on which the backup file resides. Contains one 
through seven characters. If <diskid> is specified, the system status 
communicate is invoked, determining the name of the Printer Backup 
Designate Disk (PBDD) as specified by the SO SCL. If no PBDD is in 
use, default is to the system disk. The <diskid> must always be 
terminated with a slash. 


PB<nnnnn > Filename of printer backup file to be printed. Contains one to five 
decimal digits. If the user omits the letters ‘““PB’’, they are appended 
to the front of the digits, forming the filename. In either case, the file 
must be of printer backup file-type to be printed by this utility. Leading 
zeros are not required in the PB<nnnnn> filename. 


2032801 
4-195 


eS 


= Specifies that all files identified by a ‘““PBnnnnn’’ filename will be 
printed. Only a file which is of printer backup file-type can be printed 
by this utility. 


< family > Format is <prefix> =, this specifies all printer backup files beginning 
with <prefix>, for example. MYBACKUP =. 

< filename > Filename of the named printer backup file to be printed. 

ON Specifies the device on which the printing is to be done. ‘“‘AP’’ means 


‘Any Printer’’. It instructs the utility to use the first printer device of 
any type to become available. ‘‘LP’’ indicates that the line printer is to 
be used; ‘‘SP’’ indicates the serial printer. ‘‘Station-id’’ indicates that a 
datacomm printer is to be used. The PB utility recognizes two families 
of station-ids DCPRINTxx and AP300XAxx. Their use is described in 
DATACOMM PB. If no ON option is entered, default is to the line 


printer. 
BEFORE This is a qualifier to the <file spec> and restricts the execution of 
<MM/DD/YY> _ the utility to those files created on or before the specified date. 
COPIES Specifies a non-zero decimal number containing at most 65535. 


““COPIES cc’’ specifies the <number> of copies to be printed. The 
default value is one. 


SAVE Prevents the removal of the file from disk after printing is completed. 
If “SAVE” is not specified, removal occurs. 


FORMS Files requiring special forms and ordinary files may not be printed in 
the same run of PB. If FORMS option is specified, then files requiring 
special forms will be printed. In a ‘‘forms’’ run, only files requiring the 
same record and block size of printer will be printed. The first file in 
the <file spec> that PB finds will determine the record and block size 
for the run. In a ‘‘forms’’ run, the printer remains Open all the time so 
that the user only has to AD the printer at the beginning of the run. 
After completion of the run, the printer is saved. 

In a “‘forms’’ run no headings, extra line feeds or top of forms are 
sent to the printer. The user is responsible for ensuring the paper is 
correctly aligned for the print. 


PAGE Specifies the page of the document at which printing is to begin. The 
PB utility begins from the start of the file, counting ‘‘Top-of-Forms”’ 
instructions: page numbers within the file text mean nothing. When it 
reaches the number of pages specified, (up to seven decimal digits may 
be used), it begins printing. The value of the page option may be from 
one to seven decimal digits. A value of zero is invalid. 


RECORD Selects specific parts of the printer backup file for printing by giving a 
starting record number and the number of records to be printed. More 
than one range of records may be specified, and overlapping of record 
number pairs may exist. 

NOTE: When there is no quantity in a record number pair, printing 
continues until end of file. This will only occur, however, in the last 
pair when an odd-numbered amount of record pairs is entered. The 
record option numbers, regardless of how many are entered, are always 
interpreted in pairs. An attempt to print from record 25 to endfile 
followed by printing from record 30 to endfile would, if given as ‘‘25 
30’’, result instead in the printing of the thirty records beginning at 
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record 25. Start-number, quantity values may be from one to seven 
decimal digits. A value of zero is invalid. Record number pairs do not 
have to be entered in pairs of increasing value. The number of record 
number pairs is limited to 100. 


REMOVE Causes the removal of the specified printer backup file(s). 


RM This option replaces the CMS RB utility. If the file specification equals 
«_” all files starting with PB are removed. The utility offers the 
option to remove files before a specified date. 


AUTO Results in the printing of all available PB files. The utility then enters 
an ‘‘Idle’’ state until one or more PB files become available for 
printing. 

To terminate the AUTO option, DS PB. 


NOTE: 
The AUTO option cannot be used on systems with no real-time clock. 


LIST Causes the printing of a list of all printer backup files of the form 
“PBnnnnn’’. The following information is printed for each file: 

1. “‘Packid’’ (followed by that file’s <packid>). 

2. “External backup filename’? (as it appears on disk) 

3. “Internal backup filename’’ (as it appears in the header record) 

4. ‘Print file name’’ (followed by the name used for the file by 
the program that generated it, for example ‘“LISTPRT”’). 

§. “Program Name’ (followed by the name of the program that 
generated the file, for example, ‘‘LIST’’). 

6. “Creation time HH:MM”’ (the time, in hours and minutes, at 
which the file was first opened; the range is 00:00 through 23:59). 

7. “Creation date MM/DD/YY” (the date on which the file was 
first opened). 

8 “Device kind’? (followed by “‘LP” (line printer), ‘‘AP’’ (any 
printer) or “‘SP”’ (serial printer). 

9. “Block size’? (followed by the size of the block in bytes as 
specified in the file’s header record). 

10. “RECORD SIZE” (followed by the size of the record in bytes as 
specified). 

11. “First record’? (followed by the number of the record at which 
printing begins). 

12. “FPB flags’? (followed by verbal explanations of the flags, as 
follows: 
1) ‘‘Forms’’ or ‘‘No forms’”’ 
2) ‘Labelled’? or ‘‘Unlabelled’’ 
3) ‘Translation’? or ‘‘No translation’’) 


DATACOMM PB 


PB supports any printer correctly connected through a data comm link and with a suitable entry in 
the NDL program, provided the printer satisfies the following conditions: 


1. The printer is an ASCII printer. 

2. The printer recognizes CR, LF and FF and requires no other special characters or combinations 
of characters for normal operation. 

3. The printer can handle a line of up to 132 characters, that is, printers with line width of less 
than 132 will not be damaged by being sent a line of 132 characters. 
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PB treats remote printers differently from ordinary line printers in the following ways: 


1. All tab commands will be replaced by two line feeds. 

2. The banner heading ““COMPUTER MANAGEMENT SYSTEM’? is not printed and the print 
file information is shifted to the left of its current position on normal line printers. The effect 
of this is that the file information is central on the page of 80 character paper. 


PB supports the AP journal printer. For this to occur, the AP must either be declared in the NDL 
as AP300XAxx where the last two characters are arbitrary (numbers only), or the (AP 300) option must 
be used in the initiating message. 


PB operates in the following way: 


1. PB will only go to end of job if a fatal data comm error is encountered. 
2. If PB receives an error condition from the AP printer it produces the message: 


“TERROR CONDITION REPORTED BY <printer station id>’’. 


On systems without real time clocks, it may be found that an error condition occurs (for exam- 
ple, no paper), the operator loads more paper, the print resumes and then the message is pro- 
duced. There is no sensible evasion of this problem. 

3. If the AP printer is switched off, it is frequently not possible to detect and report this condi- 
tion. In the case of a power off, data stored in the print buffers is lost (about 1 to 10 lines 
of output depending on buffer size). When the power is switched on, PB should continue the 
print. 


Examples 
PB PBO2401 


One (1) copy of file ‘“PB02401’’, which resides on the disk identified by the system status communi- 
cate, will be printed. After printing, the file **PB02401”’ will be removed from the disk. 


PB MYDISK/2401 


One (1) copy of file ‘‘PB02401”’ residing on the disk named ‘‘“MYDISK”’ will be printed. (Note that 
leading zeros are not required.) After printing, the file ““PB02401’’ will be removed from ‘‘MYDISK’’. 


PB MYDISK/2411 COPIES 22 SAVE 


Twenty-two (22) copies of file ‘“PB02411” residing on the disk named ‘‘MYDISK”’ will be printed. 
After printing, the file will remain on the disk. 


PB 01238 RECORD 25 50 300 100 SAVE COPIES 5 
Five copies of file ‘‘PB01238’’, residing on the disk identified by the system status communicate, will 
be printed. In each copy, the only records printed will be 50 records starting at record 25, followed 
by 100 records starting at record 300. After printing, the file will remain on disk. 

PB MYDISK/PB412 ON LP COPIES 3 
Three copies of file ‘“PB00412” residing on the disk named ‘““MYDISK’? will be printed on a line print- 


er. After printing, the file will be removed from disk. ; 
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PB MYDISK/= 


All PB files residing on the disk ‘‘MYDISK”’ and belonging to the family ‘‘PBnnnnn’’ will be printed. 
The PB utility will then go to EOJ. 


PB MYDISK/PB00719 RECORD 28 200 SAVE COPIES 10 ON SP 


Ten copies of file ‘‘PB00719”’ residing on disk ‘““MYDISK”’ will be printed on the serial printer. Each 
copy will contain only the 200 records which begin at the twenty-eighth record of the file. After print- 
ing, the file will remain on disk. 


PB 02413 RECORD 170 


One copy of file ‘‘PB02413’’, residing on the disk identified by the system status communicate, will 
be printed. This one copy will contain the records beginning at record 170 and continuing to the end 
of the file. After printing, the file will be removed from disk. 


PB 2413 PAGE 15 SAVE ON LP COPIES 30 


30 copies of file ‘“PB02413’’, residing on the disk identified by the system status communicate, will 
be printed on the line printer. Each copy will contain all records found after the fifteenth ‘“Top-of- 
forms” in the file. After printing, the file will remain on disk. 


PB = ON SP 


All printer backup files which belong to the “‘PBnnnnn”’ family and reside on the disk identified by 
the system status communicate will be printed on the serial printer. After printing, the files will be 
removed from disk. 


PB AUTO 
Prints all available ‘“PBnnnnn’’ files residing on the disk identified by the system status communicate. 
Then enters an “‘Idle’’ state, printing each PB file that becomes available. Does not automatically go 
to EOJ. 

PB LIST MYDISK/= 


Produces a listing which identifies all ‘‘PBnnnnn”’ files residing on the disk ‘‘MYDISK’’. Lists the ba- 
sic characteristics of each backup file. 


PB 12 ON AP300XA45 
The file PB00012 will be printed on the datacomm printer called AP300XA4 The PB utility will start 
a datacomm version of PB to communicate with the datacomm printer. The datacomm printer in this 
example is treated as an AP 300 journal printer. 

PB 15 ON PRINTSTATDC 


The file PBO0015 will be printed on a datacomm printer called PRINTSTATDC. The datacomm printer 
in this example is NOT treated as an AP300 journal printer. 


PB 6 ON PRINTSTATDC (AP300) 


The file PBO0006 will be printed on a datacomm printer called PRINTSTATDC. The datacomm printer 
in this example be will be treated as an AP 300 journal printer. : 
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PB REMOVE 6, 12, 18 
PB RM 6, 12, 18 


Removes the file PB00006, PB00012, PBOOOI8 from disk. 


PB REMOVE = 
PB RM = 


Removes all printer backup files with the names in the range PBOOOO1 through PB99999. 


PB REMOVE AB= 
PB RM AB= 


Removes all printer backup files in the family AB 


PB Messages 


then begins, controlled by the forms-control data accompanying each record. 
Files Requiring Special Forms 
For files which have the ‘‘Special Forms’’ bit set, the banner is not printed. 
The PB utility displays the following message to the user: 
SPECIAL FORMS REQUESTED 
The user must perform an ‘‘AD”’ to inform the utility whether to continue execution. The user enters: 


AD <mix-number> LPx 


NOTE 
If a line printer is already opened, then the utility closes it with lock and 
opens the printer with the forms bit set. At this time, the MCP displays a 
message on the screen requesting that the user ‘‘AD”’ the device. When a spe- 
cial-forms job concludes, the printer is closed with lock. 


Output Messages 


Message Possible Cause Suggested Action 
— FILE REQUIRES The specified file has to be Re-run PB with the FORMS 
SPECIAL FORMS AND printed on special forms. option, for example PB | 
CAN ONLY BE PRINTED FORMS 
IF FORMS IS ENABLED 
<filename> REMOVED Execution of PB RM was None. 

successful. 

—FILE NAME <filename> Self-explanatory. Correct input and re-enter. 
EXCEEDS 12 
CHARACTERS 
<filename> NOT Self-explanatory. See the second message given 
REMOVED for the reason. 
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Message 


—FILE DOES NOT 
REQUIRE SPECIAL FORMS 
AND CANNOT BE 
PRINTED WHEN FORMS 
IS ENABLED. 


—FILE REQUIRES 
DIFFERENT FORMS FROM 
PREVIOUS FILE(S) AND 
CANNOT BE PRINTED IN 
THE SAME RUN 
<filename> NOT LISTED 


FAMILY <familyname> 
NOT REMOVED 


—PB CANNOT HANDLE 
MORE THAN 2804 FILES, 
LIMIT REACHED AT FILE 
< filename > 


—FILENAME <filename> 
IS NOT A VALID FILE 
NAME 


FAMILY <familyname> 
NOT LISTED 


PARAMETER FOLLOWING 
KEYWORD <string> 
EXCEEDS <number> 


—FILE REQUIRES 
TRANSLATION WHICH IS 
NOT PROVIDED WHEN 
PRINTING AT A REMOTE 
PRINTER 


<filename> NOT PRINTED 


—HARDWARE ERROR 
DETECTED WHILE 
READING FILE 

< filename > 


IRRECOVERABLE 
DATACOMM ERROR 


—<number> IS NOT A 
VALID NUMBER 
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(continued) 
Possible Cause 


PB was started with the 
FORMS option but the 
specified file should not be 
printed on special forms. 


PB was requested to print a 
group of files of which at 
least two files require 
different forms. 


PB cannot satisfy the request 


PB cannot remove the 
specified family. 


An attempt was made to 
print more than 2804 files in 
one run. 


There are either more than 
12, or invalid characters in 
the initiating message. 

PB cannot list the specified 
family. 


The specified number is too 
high for the specified option. 


Self-explanatory. 


PB cannot print the specified 
file. 


PB has detected a parity error 
on the specified file. 


PB cannot run on the 
specified datacomm printer 
while it is not ready or in use 
by another program. 


Self-explanatory. 


Suggested Action 


Re-run the utility without the 
FORMS option. 


For one run of PB specify only 
files which use the same forms. 


See the second message given 
for the reason. 


See the second message given 
for the reason. 


Run PB on smaller groups of 
files. 


Correct input and re-enter. 


See the second message given 
for the reason. 


Correct input and re-enter. 


Print the file on a line-printer 
instead of a datacomm printer. 


See the second message given 
for the reason. 


Check integrity of the disk. 


Check status of required printer 
using various MCS commands. 


Correct input and re-enter. 
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Message 


~FILE HAS NO 
PRINTABLE RECORDS 


—CANNOT FIND RECORD 
<number> IN FILE 


—RECORD <offset> 
<number> IS NOT 
WHOLLY WITHIN FILE 


~DISK NAME <disk-id> 
EXCEEDS 7 CHARACTERS 


—FAMILY NAME <family- 
name> NOT EXPECTED 


—<filename> IS NOTA 
VALID BACKUP FILE 
NAME 


reese 


—RANGE OF BACKUP 
FILES FOR PRINTING 
MUST BE ON THE SAME 
DISK 


~FILE IS EMPTY 


—FIRST FILE IN RANGE 
<filename> IS GREATER 
THAN LAST FILE 

< filename > 


-PROGRAM HAS BEEN 
DETACHED BY MCS 


~ HARDWARE ERROR 
DETECTED WHILE 
READING DISK <disk-id> 


—<printer> IS NOT A 
VALID PRINTER TYPE 


RANGE <disk-id>/ 
<number> — <disk-id>/ 
<number> NOT LISTED 


RANGE <disk-id>/ 
<number> — <disk-id>/ 
<number> NOT REMOVED 


—FORMS MAY NOT BE 
ENABLED FOR REMOTE 
PRINTERS 
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(continued) 
Possible Cause 


The specified file is empty. 


The specified record is beyond 
the end of the file. 


The starting record is in the 
file but the number of 
records to be printed plus the 
starting record ends outside 
the file. 


The specified diskname is too 
long. 


The utility cannot list from 
family to family name. 


The utility cannot list from 
filename to filename. 


The range of files given in 
the initiating message is not 
on the same disk. 


The specified filename does 
not contain any records for 
printing. 


Self-explanatory. 


Self-explanatory. 


The utility has encountered a 
parity error on the specified 
disk. 


The printer type in the 
initiating message is not 
(AP 300). 


The diskname may only 
appear once in the initiating 
message. 


The diskname may only 
appear once in the initiating 
message. 


The FORMS option was 
specified while in the ON 
option. A datacomm printer 
is specified. 


Suggested Action 


Check input for correct 
filename. 


None. 


Correct 


Correct 


Correct 


Correct 


Correct 


None. 


Correct 


None. 


Check integrity of 


disk. 


input 


input 
input 


input 


input 


input 


and 


and 


and 


and 


and 


and 


Correct input and 


Correct input and 


Correct input and 


Correct input and 


re-enter. 


re-enter. 
re-enter. 


re-enter. 


re-enter. 


re-enter. 


the specified 


re-enter. 


re-enter. 


re-enter. 


re-enter, 


Message 


—PRINT WIDTH IS 
GREATER THAN 132 


—CANNOT FIND PAGE 
<page number > 


—FILE IS NOT A PRINTER 
BACKUP FILE 


—AUTO OPTION 
REQUIRES A REAL TIME 
CLOCK ON THE SYSTEM 


—<station name> IS NOT 
A VALID STATION NAME 


—CREATED AFTER 
SPECIFIED DATE 


RANGE <disk-id>/ 
<filename> — <disk-id>/ 
<filename> NOT PRINTED 


WIM AAKIG WIT NAIANAT 
—WAVUINU VYLINDOIVIN Or 


MCSWARM ON DISK 


ERROR CONDITION 
REPORTED BY <station> 


2032801 


(continued) 
Possible Cause 


Only files requiring printers 
of 132 characters per line will 
be printed. 

The specified page is not in 
the file. 


The filetype of the specified 
file is not suitable for PB. 


The AUTO option has been 
specified in the initiating 
message but there is no real 
time clock on your system. 
There are non-CMS characters 
in the specified station name. 


The specified file is created 
after the specified date. 


The utility cannot list the 
specified range. 


Self-explanatory. 


Suggested Action 
None. 


None. 
None. 


Contact the Burroughs sales 
representative for information 
about a real time clock. 


Correct input and re-enter. 
None. 


See the second message given 
for the reason. 


wean waecia ao fram 


Copy a good Version L1LVUli 
backup disk or generate a new 
MSCWARM file using 
MCSGEN. 


Copy a good version from 
backup disk or re-run utility if 
necessary. 
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PD (Print Disk Directory) 
(a function of SYS-SUPERUTL) 


This utility allows the operator to verify the presence on disk of a particular file or a group of files. 


Format: 


PD 


D PR2/PR020 


< disk-name > / 


< filename > 


< group-name > 


To find out if a group of files is on disk: 


PD PR2/PRO= 
PD PR3= 


To find out if several different files or groups are on disk: 


PD PR3= , PR2= 


PD GL2GLO= , GL2/GL30= , GL250 


To inquire about all files on disk: 


PD = 
PD PR2/= 


Output Messages 
Message 
ON LINE <program-name> 


<group-name> ON <disk- 
name> CONTAINS: 


NOT ON LINE <program- 
name> 


REQUESTED FILES WERE 
NOT FOUND 


END PD 
<file-name> REQUIRES 
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Possible Causes 


File found on disk if single 
file requested. 


Group of files found on disk. 


File not found on disk. 


Group not found on disk. 


Successful End of Job. 
Remainder of specified file 


Suggested Action 


None. 
None. 


Check input (re-input if 
necessary). Check for correct 
disk. 

Check input (re-input if 
necessary). Check for correct 
disk. 

None. 


Supply appropriate disk. 


(continued) 
Message Possible Causes 
OVERFLOW DISK <disk- resides on another disk. PD 
name> cannot complete until 
appropriate disk is supplied. 


<group-name> on PSEUDO Group of files found on 
DISK <pseudo-disk-id> ON 


DISK <disk-id> CONTAINS 


Suggested Action 


None. 
nseuda nack. 
? yo 


Note: See ‘‘“Common Utility Output Messages’’ for additional aid. 
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PL (Print Log Files) 


PL lists the contents of log files present during any particular session. Attempts to list other filetypes 
will fail, since a check is made on the file entries themselves and these must be of a compatible format. 
Log files created on previous release levels are incompatible. 


The utility incorporates optional facilities to analyze B 900 and B 1800 error entries, analyze statistics 
for 211 and BSMII disks and backup files. 


<option-list > is defined as : S 
a ee oe 


E 

ERROR 

STATS 

DISPLAY 

BACKUP 

PURGE 

FROM < time spec > 
TO < time spec > 
ENTRY < integer > 
MIX < integer > 
INPUT 

OUTPUT 

DEVICE < device spec > 


Format 


PL 


where < time spec > is defined as : < date > 

< time > 

<date > < time > 
< date >::= MM/DD/YY 
<time > 2: = HH:MM: SS 


4-206 


Format for DEVICE option: 


< device-id > 


< device spec > 1} = < device mnemonic > 


™~ 


< device-id >::= form DFA, CTB etc. 


< device mnemonic > ::= form DF, CT etc. 


where: 
<dvce-id> is of the form DFA CTB etc. 
<dvce-mnemonic> is of the form DF CT etc. 


NOTE 
Duplicate entries of the same device will cause PL to go to End Of Job. This 
can be inadvertently caused by having both the device-id and the family mne- 
monic name specified. For example, having DFA and DF in the DEVICE op- 
tion is a duplicate entry and will cause PL to terminate. 

NOTE 
The PURGE option can only be used on Secondary log files. That is SYS- 
LOG-HOLD, SYS-HLDjjjhh and SYS-MLGjjjhh. If used on a Primary log 
file (SYS-LOG-01 to SYS-LOG-04), the option will be ignored. 


where <time spec> = <date> 
or <date> <time> 
and <date> = MM/DD/YY 
<time> = HH:MM:SS 
The option ‘““SYSTEM”’ (or ‘‘S’’) is specified to list only system messages from the log-file. 
The option ““ERROR”’ (or ‘‘E’’) is specified to list only error messages. 


The option ‘‘FROM <time spec>”’ is used to list the logged message from the specified date and time. 
If time is not specified, then 00/00/00 is assumed. 


The option ‘‘TO <time spec>”’ is used to list the messages up to that date and time. If time is not 
specified, then the last data and time in the log are assumed. 


If the option ““ENTRY” is used, the utility will print starting from the record number specified by 
the operator. 


The ‘“‘MIX number’’ option is used to print all messages related to specified mix (number(s)). 
The “INPUT” and ‘“OUTPUT”’ options allow the operator to print either input or output messages. 


Any combination of SYSTEM, ERROR and STATS is permitted, but, if DISPLAY or BACKUP is 
requested, only ERROR and STATS are permitted. 


The default options that are set are: 
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SYSTEM, ERROR and STATS messages; 
INPUT and OUTPUT messages; 

FROM 00/00/00 00:00:00; 

TO <last date and time>; 

ENTRY 1; 

Output direct to printer. 


All entries are displayed irrespective of their mix numbers. Any of these defaults can be reset at run 
time. If no real-time clock was available when the file was created, then no check will be made on 
the ‘‘time’’ portion of the operator input, and ‘‘N/A’’ will be printed under the ‘‘TIME’’ heading on 
the report. The default for DISPLAY/BACKUP is both ERROR and STATS. 


STATS request will only output entries logged as statistics entries for BSMII and 211 disks, and only 
if those disks are used with the Standard Disk Interface (SDI) Common Controller. 


If DISPLAY is requested, then error and statistics entries will be displayed on a screen with dimensions 
not less than 80 characters wide and 10 lines deep. 


BACKUP will cause ail output to go to a disk file of type ‘‘data’*. The format of this file will be 
exactly the same as if the output had gone directly to a printer. The file will have 120 byte records 
and three records per block. Page throws will be replaced by four space-filled records. The default 
size of the file will be 4096 records, but this can be altered using MODIFY. The internal file name 
and resultant output FID will be MLOGBACKUP; the destination disk will be the system disk unless 
MODIFYed; CLOSEMODE will be LOCK, but may also be MODIFYed. 


Entries with multiple records will only have the record number and record contents displayed; all other 
columns will be blank, since the contents of these records will all be of the same type and created 
at the same time. 


Only entries which conform to either the defaults, or operator input specifications will be displayed, 
all others will be ignored. 


The range of values for ENTRY and MIX numbers are 1-65535 and 1-254 respectively. Checks at run- 
time are made on the values entered and messages issued if they are in error. 


Examples 


To print the contents of the log-file called SYS-LOG-HOLD: 
PL SYS-LOG-HOLD 


To print the error messages logged in the log-file called SYS-LOG-01: 
PL SYS-LOG-01 ERROR 


To print entries in SYS-LOG-HOLD file from record 100, related to mix number 12 from January 
1, 1979 until latest date: 
PL SYS-LOG-HOLD ENTRY 100 MIX 12 FROM 01/01/79 


Output Messages 


Message Possible Causes Suggested Action 


<filename> REMOVED Successful completion of None. 
PURGE option. 
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Message 


— PARAMETER 
FOLLOWING KEYWORD 
<keyword> EXCEEDS 

< number > 


—PARAMETER EXPECTED 


AFTER KEYWORD 
<keyword > 


~OPTION <option> HAS 
ALREADY BEEN 
SPECIFIED 


—NO FILENAME 
SPECIFIED 


UTILITY LIMIT REACHED 
WHEN RUNNING PL 


—-HARDWARE ERROR 
DETECTED WHILE 
WRITING TO FILE 

< filename > 


—HARDWARE ERROR 
DETECTED WHILE 
READING FILE 

< filename > 


NO LOG ENTRIES WERE 
FOUND TO CONTAIN 
REQUESTED 
INFORMATION 


UNRECOGNISED DEVICE 
IN MAINTENANCE LOG 
ENTRY © 


—OUTPUT FILE 
<filename> TOO SMALL 


HARDWARE ERROR 
DETECTED WHILE 
READING RECORD 
<number> OF <filename> 


—SCREEN SIZE TOO 
SMALL 


—PLEASE ENTER END TO 
FINISH OR NEXT TO 
CONTINUE 
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(continued) 
Possibie Causes 


Incorrect input to PL. 


The specified ontion occurs 
more than once in the 
initiating message. 


There is no filename in the 
initiating message. 


The utility cannot handle the 
information in the specified 
log-file. 


The utility has encountered an 
error while writing to the 
printer backup file, since 
BACKUP was specified in the 
initiating message. 


The utility has encountered an 


error while reading the 
specified file. 


The specified logfile is empty. 


Self-explanatory. 


The printer backup file is too 
small. 


The utility has encountered a 
parity error on the specified 
file. 


The screen on which PL is to 
run is smaller than 80 
characters per line or less 
than 14 lines per screen. 


Normal message to give the 
possibility to stop or to 
continue. 


Suggested Action 


Correct input and re-enter. 


Correct input and re-enter. 


Correct input and re-enter. 


Check integrity of the specified 
file. 


Check integrity of the disk. 


Check integrity of the disk. 


None. 


None. 


Use SO command to increase 
printer backup filesize. 


Check integrity of the specified 
file. 


Use FD command to change 
screen format or use another 
terminal with the right screen 
size. 


Enter AX <mix-no> END or 
AX <mix-no> NEXT. 
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Message 


<number> RECORDS 
WRITTEN TO BACKUP 
FILE <filename> 


PRIMARY LOG FILE 
<filename> MAY NOT BE 
PURGED 


— LOG FILE WILL BE 
PURGED ONLY IF ALL 
ENTRIES ARE PRINTED 


ENTRY OPTION IGNORED 
FOR MAINTENANCE FILE 
< filename > 


—DEVICE <device.type> 
HAS ALREADY BEEN 
SPECIFIED 


—SPECIFIED DEVICE 
<device.type> NOT 
RECOGNISED 


—SPECIFIED DEVICE 
<device.type> WAS NOT 
FOUND IN HARDWARE 
CONFIGURATION TABLE 
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(continued) 
Possible Causes 


Self-explanatory. 


An attempt was made to 
purge a primary log file. 


If PURGE option is specified 
and all entries are not 
printed, this message is 
displayed. 


An attempt was made to list 
a maintenance log file with 
the ENTRY option. 


The specified device occurs 
more than once in the 
initiating message. 


The specified device is not 
known to the utility. 


The specified device is not 
one of the devices of this 
configuration. 


Suggested Action 
None. 


None. 


None. 


Correct input and re-enter. 


Correct input and re-enter. 


Correct input and re-enter. 


Correct input and re-enter. 


PPID (Pseudo Pack Identifier Display — B 900 Only) 


The Pseudo Pack Identifier Display utility may be used to list the Pseudo Pack Identifier Table (PPIT). 
This utility does not provide the *<file-name> option in the initiating message. The syntax for this 
utility is: 


< disk-id > 
—— PPID ile ee 1 
L PRINT I 


If PRINT is specified, the output will be listed on a printer, otherwise the output will be displayed 
on the Operator Display Terminal (ODT). 


One of the following messages will be output for each used entry in the PPIT 


disk-id — PHYS.UNITxx/READY (Physical disk on line) 
disk-id — PHYS.UNIT xx/LOCKED (Physical disk on line) 
disk-id — PHYS.UNIT xx/NOT READY (Physical disk not on line) 
disk-id — PSEUDO ON physical disk-id (Restricted Pseudo disk) 
disk-id — PSEUDO UNRESTRICTED (Unrestricted Pseudo. disk) 
disk-id — PSEUDO UNRESTRICTED/ (System Pseudo disk) 
SYSTEM 

xx is the logical unit number of the fixed disk. 


Physical unit entries are displayed in order of logical unit number, each being immediately followed 
by entries of pseudo packs restricted to that particular unit. Lastly, unrestricted pseudo pack entries 
are displayed. : 


Output Messages 


Message Possible Causes Suggested Action 
NO PSEUDO-PACK TABLE _ No pseudo pack identifier None. 
ON SYSTEM DISK table was found on the 
system disk. 
— HARDWARE ERROR An error was encountered None. Irrecoverable error. 
DETECTED WHILE while reading the PPIT. 


READING PSEUDO-PACK 
TABLE ON DISK <disk- 


name> 
— PHYSICAL DISK <disk- Another program is using the Wait until the other program 
name> LOCKED specified disk. stops using the specified disk, 


then re-run PPID. 


Note: Refer to ‘“‘Common Utility Output Messages’’ for additional aid. 
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RM (Remove Files from Disk) 
(a function of SYS-SUPERUTL) 


This utility allows the removal of individual files and groups of files from disk. The disk areas associ- 
ated with those files are returned to the available table. 


If the utility detects that a keyfile is to be removed and the <BOTH> option has been specified, then 
it will remove both the keyfile and the associated data file if both are on disk. If <BOTH> is not 
specified, then only the keyfile will be removed. 


Format: 


< disk-id > / < group-name > 


RM 


< filename > 
Examples: 


To remove a single file: 


RM AR300 
RM PRI/PR300_, 


To remove a group of files: 


RM AR= 
RM _ INDISK2/IN3 = 


To remove several different groups and/or individual files: 
RM 1C230, IN076, INDISK1/IN2 = 
To remove a keyfile and associated data file: 
RM PR200K <BOTH> 
A request for the removal of a system file will cause the utility to output the following: 


filename IS A SYSTEM FILE 
AX ‘‘mix number’’/RM ACPT 


Then, to remove a system file: 

AX mix-number OK 
If the operator types any other sequence, the system file will not be removed. 
Example: 


RM NDL= 
NDL.INTERP IS A SYSTEM FILE 
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12/RM ACPT 
AX 12 OK 


' Output Messages 


Message 
<filename> REMOVED 


<FILENAME> NOT 
REMOVED — FILE NOT 
FOUND 


<filename> NOT 
REMOVED - FILE IS 
CURRENTLY BEING USED 
BY ANOTHER PROGRAM 


<filename> NOT 
REMOVED — SYSTEM 
FILE 


INDEXED FILE PAIR 


< filename > 


beaweiteaaay — 


<filename> REMOVED 


INDEXED FILE PAIR 
<filename> <filename> 
NOT REMOVED 


INDEXED PAIR 
<filename> < filename > 
NOT REMOVED 


END RM 


<filename> IS A SYSTEM 
FILE 


~ FILE IS NOT A 
KEYFILE 


— HARDWARE ERROR 
DETECTED WHILE 
READING KEYFILE FILE 
< filename > 
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Possible Causes 
File was removed. 


Specified file was not 
removed because it is 
currently being used by the 
system. 


Specified file was not 
removed because it is 
currently being used by the 
system. 


Specified file was not 
removed because it is a 
‘“‘system’’ file (for example 
MCP, an interpreter). 


Keyfile and associated data 
file were removed. 


Keyfile and associated data 
file were not removed. This 
message is followed by a 
second message giving the 
reason. 


Specified keyfile and data file 
were not removed because at 
least one is currently being 
used by the system. 


Normal EOJ message. 


Specified file is a system file 
and is protected. 


<BOTH> was specified for 
a file which is not a keyfile. 


The utility has encountered a 
parity error while reading the 
file. 


Suggested Action 
None. 
Check input (re-input if 
necessary); check for correct 
disk. 


Wait until file is no longer in 
use, then re-input. 


If a file is to be removed, type 
“AX <mix-no>/RM filename 
OK’’. If file is not to be 
removed, type AX <mix-no>/ 
RM NO. 


None. 


Check input (re-input if 
necessary); or check for correct 
disk. 


Wait until files are no longer in 
use, then re-input. 


None. 


Enter ‘“‘AX <mix-no> OK’”’ to 
remove the file or AX <mix- 
no> to leave it on disk. 


None. 


Check integrity of the disk. 
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SCR (System Confidence Routine) 


The SCR utility is used to establish a level of confidence in the overall performance of the software/ 
hardware interface of a CMS system. It is not intended to perform the function of an MTR program 
in rigorously testing isolated hardware components, nor is it intended as a proof of correctness for 
system software. 


The SCR operates under MCP control, and relies on the MCP for basic error detection. In addition, 
SCR makes certain comparisons between actual results and expected results, and performs checks on 
output results. 


Operator input required is minimal, and is restricted to initiation of the utility and replies to prompts 
displayed immediately thereafter. Information concerning errors detected and program performance is 
displayed at the SPO throughout execution of the SCR. The SCR may be DS’ed by the user at any 
time. The user specifies the number of records to be read. 


The integrity of disk files is maintained: all disk files created by SCR are CLOSEd with RELEASE. 
Thus, when the utility goes to EOJ, those files do not remain on disk. 


The SCR utility is written in MPL. One of its major subsections (CPU.IO) ZIPs to two independent 
programs, one of which is written in MPL and the other in COBOL. 


The utility comprises four major subsections. The user can specify which of these subsections are to 
be performed for any given run of SCR. To assist him in making his selection, a HELP display is 
provided. The four subsections are: 


1. DCR Disk Confidence Routine. This tests CMS disk input/output operations. 


2. CPU.IO This subsection tests the interface between the MCP, IO, the MPL and 
COBOL Interpreters by ZIPping to an MPL program which outputs the result 
of calculations to disk, and by ZIPping to a COBOL program which prints 
the edited results of its calculations. 


3. MT.IO This subsection writes files of binary information to user-selected magnetic 
devices, reads these files back, and compares the output and input records. 


4. OTHER.IO This subsection outputs files of information to user-selected non-magnetic 
devices, reads the files back and checks them when possible. Currently, this 
subsection only applies to printer, and therefore relies on the user to perform 
a visual check of the information output. 


Any or all of these subsections may be selected by the user for a given run of the utility. The order 
of performance is determined by the order of selection. The number of iterations for each of the sub- 
sections may be specified by the user; all iterations of a given subsection are performed before execu- 
tion of another subsection is begun. 


It is recommended that care is taken when specifying the size of file for the DCR WRITE-INDEX 
test. Since the records are written and read randomly, access time becomes proportionately greater as 
the filesize increases. 
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Operating Instructions 


Enter: SCR 


Prompt 1 is displayed: 


Prompt 1: 


‘ENTER TEST NUMBERS OR ENTER HELP” 
“ENTER SPACE FOR DEFAULT VALUES OR 0 TO TERMINATE SCR” 


Possible Reply 


AX <mix-no> 
HELP 
<PROMPT 1> 


AX <mix-no> 
<empty > 


AX <mix-no> 0 


AX <mix-no> <test 
list > 
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Possible Resulting 
Output 


Possible Cause 


ENTER (ON 1 LINE) NUMBERS FOR 


TESTS WANTED 
1 = 


DISK CONFIDENCE ROUTINE (DCR) 


2 = CPU/IO INTERACTION TEST 


(CPU.IO) 


3 = MAGNETIC DEVICE EXERCISER 


(MT.IO) 


4 = NON-MAGNETIC PERIPHERAL 
EXERCISER (OTHER.IO) 
ALL = ALL TESTS WANTED 


rAn Rm EFAULL Ur 


ENTER SPACE FOR DEFAUL 


AYTInTNG 
VALUD)S 


OR 0 TO TERMINATE SCR 
DEFAULT VALUES ARE: TESTS 1,2,4 
DCR — ALL SUBTESTS, 1 DISK 
INDEX FILESIZE 100 RECORDS 
READING i000 RANDOM SECTORS 
CPU.IO — 1 ITERATION 
OTHER.IO — 1 ITERATION 


<PROMPT 1> 
<PROMPT 2.1> 


SCR TERMINATED 
BY USER 


INVALID INPUT 
CHARACTER 
<PROMPT 1> 


SCR INITIATING 
MESSAGE ERROR 
DUPLICATE SCR 
SUBTEST SCR 
ABORTED 


DUPLICATE TEST 
NO. 


<PROMPT 2> 


The default values 
have been chosen. 


Utility has been 
terminated. 
Test list input did not 


consist of valid test 
numbers or ‘‘ALL’’. 


Self explanatory. 


A digit has been 
repeated in the test 
list entered. 


Test 1 (DCR) or 
‘““ALL”’ has been 
selected. 


Suggested Action 


Select tests required and 
input test numbers, or 
ALL. 


Enter disk-name. 
None. 


Re-input test list, or 
terminate the utility. 


Re-start SCR utility, 
taking care to only enter 
one of each test 
number. 


Re-enter test list, or 
terminate the utility. 


Refer to possible replies 
to Prompt 2. 
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(continued) 
Possible Reply Possible Resulting Possible Cause Suggested Action 
Output 

<PROMPT 3> Test 2 (CPU.IO) or Refer to possible replies 
‘‘ALL”’ has been to Prompt 3. 
selected. 

<PROMPT 4> Test 3 (MT.IO) or Refer to possible replies 
‘“ALL”’ has been to Prompt 4. 
selected. 

<PROMPT 5> Test 4 (OTHER.IO) Refer to possible replies 
or ‘“‘ALL’’ has. been to Prompt 5. 
selected. 


Spaces act as a delimiter but are ignored. 


If the reply contains the string ‘‘ALL’’, any valid digits contained in the reply are ignored. 
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i 
Prompt 2: 


“ENTER NUMBER OF DCR ITERATIONS — DEFAULT = 1” 


Possible Reply Possible Resulting Possible Cause Suggested Action 
Output 
AX <mix-no> <PROMPT 2.1> DCR subsection will 
<empty > be performed once. 
AX <mix-no> <PROMPT 2.1> DCR subsection will None. 
<decimal-no > be performed 
<decimal-no> of 
times. 
PROMPT 2.1 


“ENTER DISK.ID TO CONTINUE. 
ENTER SPACE TO TERMINATE DCR” 


Possible Reply Possible Resulting Possible Cause Suggested Action 
Output 
AX <mix-no> DCR TERMINATED _ DCR has been None. 
<empty > BY USER terminated. 
AX <mix-no> FETCH VALUE = The MCP has been None. 
<disk-name> <hex-no. > unable to open 


DISK <disk-name> <disk-name>. 
NOT AVAILABLE 
DCR ABORTED 


FETCH VALUE = ~~ MCP input error on None. 
<hex-no. > reading the disk label. 

READ ERROR ON 

<disk-name> LABEL 

DCR ABORTED 


ILLEGAL The default System Use the System Disk, as 
PARAMETER LIST Disk identifier has the disk name of the 
0000000 been used. actual disk. 
<PROMPT 2.1> 
DISK <disk-name> DCR does not use Re-enter a non pseudo- 
IS A PSEUDO-DISK PSEUDO-DISK disk- disk disk-name. 
<PROMPT 2.1> names. 
<PROMPT 2.2> <disk-name> has Proceed to the 

been opened instructions for 


successfully and disk- PROMPT 2.2. 
label has been read. 


PROMPT 2.2: 


“SECOND DISK TO BE TESTED? <Y or N>”’ 
If the answer to prompt 2.2 was ‘‘Y’’, denoting that a second disk is to be tested, prompt 2.1 is dis- 
played. Refer to the following table for possible replies. 
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Possible Reply 


AX <mix-no> 
<neither Y nor N> 


AX <mix-no> N 


AX <mix-no> Y 


Possible Resulting 
Output 

REPLY NOT ‘‘Y’”’ 
OR een”? 
<PROMPT 2.2> 
SECOND DISK NOT 
WANTED 
<PROMPT 2.3> 


<PROMPT 2.1> 


Possible Cause 


Reply not ‘‘Y’’ or 
SON? 


No second disk was 
specified. 


Second disk is to be 
tested. 


Suggested Action 


Enter Y or N. 


Continue. 


Enter disk-name or 
space. 


Prompt 2.2 (continued) — Possible replies if a second disk has been requested: 


Possible Reply 


AX <mix-no> 
<empty > 


AX <mix-no> 
<disk-name> 


DISK <disk-name> 
IS A PSEUDO-DISK 
<PROMPT 2.1> 
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Possible Resulting 
Output 


DCR TERMINATED 
BY USER 


FETCH VALUE = 
<hex-no. > 

DISK <disk-name> 
NOT AVAILABLE 
DCR ABORTED 


FETCH VALUE = 
<hex-no. > 

READ ERROR ON 
<disk-name> LABEL 
DCR ABORTED 


ILLEGAL 
PARAMETER LIST 
0000000 

<PROMPT 2.1> 


CAPACITIES ON 
2ND DISK NOT 
SAME AS ON IST 
DCR ABORTED 


<PROMPT 2.3> 


Possible Cause 


DCR has been 
terminated. 


The MCP has been 
unable to open 
<disk-name>. 


MCP input error on 
reading the disk label. 


The default System 
Disk identifier has 
been used. 


DCR does not use 
PSEUDO-DISK disk- 
names. 


Indicates inequalities 
in the sizes of the 
SYSMEM files or in 
the number of sectors 
per buffer between the 
two disks. 


Disk capacities have 
been compared and 

are equal, disk-name 
has been successfully 
opened and the disk- 


label has been 
successfully read. 


Suggested Action 
None. 


None 


None. 


Use the System Disk as 
the disk name of the 
actual disk. 


Re-enter a non pseudo- 
disk disk-name. 


None. 


Proceed to the operating 
instructions for 
PROMPT 2.3. 


PROMPT 2.3: 


“ENTER TEST NUMBERS OR ENTER HELP 


ENTER SPACE TO TERMINATE DCR” 


Possible Reply 


AX <mix-no> 
<empty > 


AX <mix-no> 
HELP 


AX <mix-no> <non- 
numeric entry > 


AX <mix-no> <test 
number list > 
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Possible Resulting 
Output 
DCR TERMINATED 
BY USER 


ENTER ON 1 LINE 
NUMBERS FOR 
TESTS WANTED 

= READ.ALL 
2 = OPEN.FILES 
3= 
READ.CYLINDERS 
4 = WRITE.INDEX 
5 - 
READ.RANDOM 
ALL = ALL TESTS 
WANTED 
SPACE = 
TERMINATE DCR 
<PROMPT 2.3> 


NON-NUMERIC 
INPUT CHARACTER 
<PROMPT 2.3> 


<PROMPT 2.3> 


DUPLICATE TEST 
NO. 


SCR INITIATING 
MESSAGE ERROR 
DUPLICATE DCR 
SUBTEST SCR 
ABORTED 


<PROMPT 2.4> 


<PROMPT 2.5> 


Possible Cause 


DCR has been 
terminated. 


Help function has 
been requested. 


No valid test numbers 
input. 


Test numbers not in 
the range 1-5 and not 
“ALL’’. 


A test number has 
been repeated. 


Self-explanatory. 


Test 1 or ‘‘ALL”’ 
tests have been 
selected. 


Test 4 or ‘“‘ALL”’ 
tests have been 
selected. 


Suggested Action 


Select tests required and 
input, else terminate the 


utility. 


Re-input correctly. 


Re-input correctly. 


Re-enter correctly. 


Re-start SCR utility, 
taking care to only enter 


one of each test 
number. 


Proceed to input for 


PROMPT 2.4. 


Proceed to input for 


PROMPT 2.5. 
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(continued) 


Possible Reply 


Possible Resulting 
Output 


<PROMPT 2.6> 


Possible Cause 


Test 5 or ‘“‘ALL”’ 
tests have been 
selected. 


Suggested Action 


Proceed to input for 
PROMPT 2.6. 


If tests 1, 4, or 5 (or ALL) have not been requested, the utility will begin to execute test 2 and/or 


test 3 if selected. 
PROMPT 2.4: 


“MULTI-SECTOR BUFFERING WANTED? <Y or N>” 


This prompt is displayed if test 1 or ALL is requested. 


Possible Reply 


AX <mix-no> Y 


AX <mix-no> N 


PROMPT 2.5: 


Possible Resulting 
Output 
REPLY NOT ‘‘Y”’ 
OR sen? 


<PROMPT 2.4> 


MULTI-SECTOR 
BUFFERING NOT 
WANTED 


Possible Cause 


Reply was not Y (for 


yes) or N (for no). 


When performing test 
1 (READ.ALL), a 
buffered read will be 
invoked, with 32 
sectors being read in 
each read operation. 


When performing 
READ.ALL (test 1), 
single sector reading 
will be invoked, thus 
maximizing head 
movement. 


Suggested Action 


Enter Y or N. 


None. 


None. 


“ENTER NUMBER OF RECORDS IN INDEX.FILE OR SPACE TO CANCEL TEST”’ 


This is displayed if test 4 or ALL has been requested. The number specified is used as the size of 
the index file written and read in test 4. 


Possible Reply 


AX <mix-no> 
<empty > 


AX <mix-no> 
<decimal no> 
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Possible Resulting 
Output 
Test 4 
(WRITE.INDEX) will 
not be performed. 


Possible Cause 


REQUESTED IX FILE n is greater than the 


SIZE EXCEEDS DISK 
CAPACITY 
<PROMPT 2.5> 


number of sectors on 


the disk. 


Suggested Action 


Enter a number smaller 
than or equal to the 
number of sectors on 
the specified disk. 


Sn eS SS 


(continued) 


Possible Reply Possibie Resuiiing Possible Cause Suggested Action 
Output 
AX <mix-no><non- NON-NUMERIC The reply was not a___ Re-input the desired 
numeric entry > INPUT CHARACTER decimal number. (decimal) number of 
<PROMPT 2.5> records. 
PROMPT 2.6: 


“ENTER NUMBER OF RANDOM SECTORS TO BE READ FROM EACH DISK OR SPACE 
TO CANCEL TEST’’ 


This prompt is displayed if test 5 or ALL has been specified. 


The number entered must be less than 16 777 216 and will be used as the number of sectors to be 
read in test 5 (READ.RANDOM). 


Possible Reply Possible Resulting Possible Cause Suggested Action 
Output 
AX <mix-no> READ.RANDOM 
<empty > (Test 5) will not be 
7 performed. 
AX <mix-no> INPUT NUMBER > _ Self explanatory. Re-input number smaller 
<decimal no> 16777215 than 16777216. 
<PROMPT 2.6> 
AX <mix-no><non- NON-NUMERIC Self explanatory. Re-input desired 
numeric entry> INPUT CHARACTER (decimal) no. 


<PROMPT 2.6> 


TEST 1 (READ.ALL) may output any of the following error messages: 


Message Possible Cause Suggested Action 
READING ALL n SECTORS Number of records in None. 
ON <disk-name> SYSMEM, for each disk being 


MULTI-SECTOR BUFFERED tested, is obtained and that 
(or) number displayed in this 
BUFFERED BY SECTOR message (n). 
The number of records in 
SYSMEM may be fewer than 
the number of physical sectors 


on a disk. 
MULTI-SECTOR If OPEN fails on a 32 sector None. 
BUFFERING NOT buffered SYSMEM, this 
AVAILABLE message is displayed and input 


(for both disks, if two are 
used) will be via the single- 
sector buffers. 
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Message 


ERROR ON <disk-name > 
MULTI-SECTOR READ 


BUT NO ERRORS WHEN 
SECTORS READ 


READ ERROR ON <disk- 
name>,<sector address> 


NO ERROR ON MULTI- 
SECTOR READ 


LISTED AS BAD IN 
AVAIL.TABLE 

(or) 

NOT LISTED AS BAD IN 
AVAIL.TABLE 


n SECTORS READ 
n BAD SECTORS READ ON 
< disk-name > 


READING ALL SECTORS 
ABORTED : 


READING ALL SECTORS 
COMPLETED. <n> 
SECTORS READ ON <disk- 
name> 


Test 2 (OPEN.FILES) may display any of the following messages: 
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(continued) 
Possible Cause 


If multi-sector buffering is 
being used and the MCP 
reports an error when a given 
track is input to the buffer, 
this message is displayed. 
DCR re-reads the track via 
the single sector buffer in an 
attempt to isolate the bad 
sector. 


The MCP has reported no 
errors when records of the 
track have been re-read. 


The MCP has reported a read 
error, Other than when a 
multi-sector buffer is first 
filled and DCR displays this 
message. 


Multi-sector buffering is being 
used and a read error was not 
reported when the buffer was 
first filled. 


The available table has been 
checked, and appropriate 
message output. The count of 
sectors for which read errors 
have been reported is 
maintained. 


After every 10% of sectors on 
each disk being used have 
been read, DCR displays this 
message. 


More than 300 read errors 
have been reported on one 
disk — READ.ALL will be 
terminated if this message is 
output. 


All sectors have been read 
and, for each disk, a 
summary of read errors 
reported. DCR proceeds to 
next specified test. 


Suggested Action 


None. 


None. 


None. 


None. 


None. 


‘None. 


None. 


None. 


Message 
OPENING UP TO 20 FILES 
ON <disk-name> 


ERROR READING FDNL 
ON <disk-name> OPEN. 
FILES TRUNCATED 


FILE <file-name> ON 
<disk-name> OPENED 


<file-id> ON <disk-name> 
DID NOT OPEN 


NO FILES ON <disk-name> 


<n> OPENS TRIED ON 
< disk-name > 


<n> SUCCESSFUL, <n> 
UNSUCCESSFUL 


Test 3 (READ.CYLINDERS) may display any of the following messages: 


Message 


READING <n> 
CYLINDERS ON <disk- 
name> 


READ ERROR ON <disk- 
name>, SECTOR <sector 
address > 


Possible Cause 


This is displayed for each 
disk. 


The file directory name-list 
(FNDL) is searched to obtain 
a maximum of 20 file 
identifiers. This error is 
reported while reading the 
FDNL. DCR will attempt to 
open only those files whose 
identifiers were obtained 
before the error was reported. 


DCR attempts to open 
conditionally each of the files. 
Names were obtained from the 
FDNL’s. This message 
indicates that the open is 
successful and closes the file 
and removes it without 
performing any other I/O 
operations. 


Attempt to open a file is 
unsuccessful. 

The address of an FDNL is 
incorrect or the FDNL is 
corrupt in a way that does 
not produce MCP read error 
reports. 

Attempts have been made to 
open all possible (up to 20) 
files on a given disk. 


Summary of the results of all 
possible opens (up to 20). 


Possible Causes 


For each disk DCR obtains 
the number of cylinders on 
the disk and displays this 
message. , 


If the MCP reports an error 
on a read, DCR displays this 
message. 


Suggested Action 


None. 


None. 


None. 


None. 


None. 


None. 


None. 


Suggested Action 
None. 


None. 


After every 10% of the sectors (cylinders) read on each disk, DCR displays: 


‘““<n> SECTORS READ”’ 
and from each disk: 


2032801 


a ee 


‘““<n> BAD SECTORS READ ON <disk-name>’’ 
n being a count maintained of MCP error reports during this test. 


When all cylinders have been read, DCR displays: 
“READING CYLINDERS COMPLETED” 

and for each disk a summary of the read errors reported by the MCP: 
““<n> BAD SECTORS READ ON <disk-name>”’ 


It then proceeds to the next test specified by the user. 


Test 4 (WRITE.INDEX) may display any of the following messages: 


Message Possible Cause Suggested Action 
WRITING INDEX FILE ON This is displayed for each disk None 
<disk-name> being tested. 
FETCH VALUE= <hex.no> DCR attempts to open an None 
OPEN FAILED ON <disk- arbitrarily named 
name> (“YELNOC’’) index file on 
WRITE.RANDOM each disk. If the open fails, 
ABORTED this message is displayed and 


the test is abandoned. 


FETCH VALUE= <hex.no> This is displayed by DCR if None. 
the MCP reports a conditional 
failure on any write operation. 


DATA SPACE NOT There is not enough user disk Remove some back up files to 
AVAILABLE ON <disk- for the utility to operate. make room and re-execute the 
name> utility. 


If the MCP reports an error on any write operation during WRITE.INDEX, the following message 
is displayed: 


“‘WRITE ERROR ON <disk-name>, KEY = < key-value > 


The utility compares the sector number against the list of bad sectors in the disk’s available table, dis- 
playing one of the following messages accordingly: 


“LISTED AS BAD IN AVAIL.TABLE” 
or 
“NOT LISTED AS BAD IN AVAIL.TABLE” 


Message Possible Causes Suggested Action 
WRITING INDEX FILE A conditional failure or an AX <mix-no><empty> 
TRUNCATED error on any write operation. 


No more records are written 
(to either file if two disks are 
being tested). 


READ ERROR ON <disk- DCR reads back index files in None. 
name>, KEY = <key- the order in which they were 
value > written. If the MCP reports 
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Message 


READING INDEX 
ABORTED 


DATA MISMATCH ON 
<disk-name> RECORD 
<hex.number > 


WRITING INDEX FILE 
FINISHED 


READING INDEX 
COMPLETED 


<n> BAD SECTORS READ 


ON <disk-name> 


<n> DATA MISMATCHES 
ON <disk-name> 


(continued) 
Possibie Causes 
an error on any read 
operation, this message is 
displayed by DCR, which 
maintains a count of bad 
sectors for each disk. 


Suggested Action 


reported on a file, proceeds to 
next subtest requested. 


When each record is read in, None. 
the data is compared against 

the value determined by the 

record’s ordinal number. If 

the values are not identical, 

DCR displays this message. 

All records have been written. None. 
All records have been read. None. 
Summary of read error None. 
reporis. 

Summary of data mismatches. None, 


Test 5 (READ.RANDOM) may display any of the following messages: 


Message 
READING <n> RANDOM 
SECTORS ON <disk-name> 


READ ERROR ON <disk- 
name>, SECTOR <sector 
address > 


READING RANDOM 
SECTORS ABORTED 


<n> SECTORS READ 


<n> BAD SECTORS READ 


2032801 


Possible Cause Suggested Action 


This is a response in reply to None. 
number of random sectors 


requested in PROMPT 2.6. 


If the MCP reports a read 
error, DCR outputs this 
message and maintains a 
count of read-errors. 


None. 


If more than 300 errors are None. 
reported from a disk, DCR 
displays this message and 


abandons the test. 


After every 10% of the 
specified number of sectors 
have been read from each 
disk being tested, this message 
is displayed. 


After every 10% of the 
specified number of sectors 
have been read from each 


None. 


None. 
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Message 


READING RANDOM 
SECTORS COMPLETED 


<n> BAD SECTORS READ 
ON <disk-name> 
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(continued) 
Possible Cause Suggested Action 
disk being tested, this message 
— a summary of the error 
error count n — is output. 


When the total number of None. 
requested sectors have been 

read from each disk, this 

message is displayed. 


Total number of bad sectors None. 
read. 


Prompt 3: 


“ENTER NUMBER OF ITERATIONS FOR CPU.IO — DEFAULT = 1.” 


Possible Reply Possible Resulting Possible Cause Suggested Action 
Output 
AX <mix-no> The CPU.IO test will None. 
<empty > be performed once. 
AX <mix-no> CPU.IO will be None. 
<decimal no> performed the number 


of times specified, up 
to a maximum of 99 
times. Only the first 
two digits are read. 


INVALID INPUT A non-decimal Re-input number of 
CHARACTER character was input. iterations. 
<PROMPT 3> 
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Prompt 4: 


“ENTER NUMBER OF MT DEVICES — DEFAULT = 1.” 


Possible Reply Possible Resulting Possible Cause Suggested Action 
Output 
AX <mix-no> <PROMPT 4.1> SCR will write to and Refer to possible replies 
<empty > read from one to Prompt 4.1. 
magnetic tape reel. 
AX <mix-no> <PROMPT 4.1> SCR will write to and Refer to possible replies 
<decimal no> read from the number to Prompt 4.1 


of magnetic tape reels 
specified — up to a 
maximum of five 
reels. Only the first 
character input is 


read. 
INVALID INPUT An invalid non- Re-input no. of reels 
CHARACTER decimal has been required. 
<PROMPT 4> input. 


PROMPT 4.1: 
“ENTER NUMBER OF CS DEVICES — DEFAULT = 0” 


Possible Reply Possible Resulting Possible Cause Suggested Action 
Output 
AX <mix-no> <PROMPT 4.2> SCR has used the Refer to possible replies 
<empty > default value of zero, to Prompt 4.2. 


and will not write to 
or read from cassette. 


AX <mix-no> <PROMPT 4.2> SCR will attempt to Refer to possible replies 
<decimal no> write to and read to Prompt 4.2 

from the specified 

number of cassettes, 

up to a maximum of 

five cassettes. 


INVALID INPUT Self explanatory Re-enter (decimal) no. 
CHARACTER 
ERROR: MORE The total number of Re-input the parameters 
THAN 5 DEVICES magnetic tape reels for MT and CS devices, 
REQUESTED. and cassettes taking care that the 
<PROMPT 4> requested, specifically total does not exceed 
or by default, exceeds five. 
five. 
ERROR = TOTAL Zero devices (magnetic Re-enter the parameters 
MAGNETIC tape reels and for MT and CS devices, 
DEVICES = 0 cassettes) were taking care that the 
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(continued) 


Possible Reply Possible Resulting Possibie Cause Suggested Action 
Output 
<PROMPT 4> explicitly requested. total is greater than 
zero. 
PROMPT 4.2: 


“ENTER NUMBER OF RECORDS IN FILE — DEFAULT = 256” 


Possible Reply Possible Resulting Possible Cause Suggested Action 
Output 
AX <mix-no> <PROMPT 4.3> Each file written to Refer to possible replies 
<empty> and read from to Prompt 4.3. 


magnetic tape reels 
and/or cassettes will 
contain 256 records. 


AX <mix-no> <PROMPT 4.3> The size of all Refer to the possible 
<decimal no> magnetic media files replies to Prompt 4.3. 
will be the (3-digit) 
decimal number 


specified. 
ERROR : FILESIZE Seif explanatory. Reenter number of 
=0 records greater than 
<PROMPT 4.2> zero. 
INVALID INPUT Self explanatory Re-enter number. 
CHARACTER 
<PROMPT 4> 


PROMPT 4.3: 
“ENTER NUMBER OF ITERATIONS — DEFAULT = 1” 


Possible Reply Possible Resulting Possible Cause Suggested Action 
Output 
AX <mix-no> READY SCRATCH The MT.IO subsection Make ready the specified 
<empty > TAPES ON <m> will be performed number of tapes on 
MAGNETIC TAPE once only. their drives. 
DRIVES, <n> 
CASSETTE DRIVES 
AX <mix-no> READY SCRATCH — The MT.IO subsection Make ready the specified 
<decimal no> TAPES ON <m> will be performed the number of tapes on 
MAGNETIC TAPE number of times their drives. 
DRIVES, <n> specified. 
CASSETTE DRIVES 
INVALID INPUT Self explanatory. Re-enter number. 
CHARACTER 
<PROMPT 4> 
2032801 
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Prompt 5: 


“ENTER NUMBER OF OTHER.JO ITERATIONS — DEFAULT — 1” 


Possible Reply 


AX <mix-no> 
<empty > 


AX <mix-no> 
<decimal no> 


PROMPT 5.1: 


Possible Resulting 


Output 
<PROMPT 5.1> 


INVALID INPUT 
CHARACTER 
<PROMPT 5> 


<PROMPT 5.1> 


Possible Cause 


The OTHER.IO 
subsection will be 
performed once only. 


The input string 


contains a non-decimal 


character. 


The OTHER.IO 
subsection will be 


performed the number 


of times specified by 
the first two digits of 
the input string (that 
is, up to 99 times). 


“IS PRINTER TO BE TESTED? <Y OR N>” 


Possible Reply 


AX <mix-no> Y 


AX <mix-no> N 


AX <mix-no> <not 
sh aed or NP? > 


PROMPT 5.2: 


“IF CARD PUNCH AND READER TO BE TESTED, ENTER Y.” 
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Possible Resulting 
Output 


<PROMPT 5.2> 


<PROMPT 5.2> 


REPLY NOT ‘‘Y”’ 
OR sen”? 
<PROMPT 5.1> 


Possible Cause 


SCR will write files 
(the number of files 
being specified by the 
reply to Prompt 5) of 
a pre-determined 
content to the first 
printer available at 
execution time. 


The printer test will 
not be performed. 


Self explanatory. 


Suggested Action 


Refer to possible replies 
to Prompt 5.1. 


Re-input the required 
no. of iterations 
correctly. 


Refer to possible replies 
to Prompt 5.1. 


Suggested Action 


Refer to possible replies 
to Prompt 5.2. 


Refer to possible replies 
to Prompt 5.2. 


ya a = a a SSS SSS ES 


Possible Reply 


AX <mix-no> Y 


AX <mix-no> N 


AX <mix-no. > 
<not ‘“Y’’ or “N’’> 
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Possible Resulting 
Output 


CARD — 
PERIPHERALS NOT 
IMPLEMENTED 


REPLY NOT “‘Y”’ 
OR eeony?? 
<PROMPT 5.2> 


Possibie Cause 


No card tests will be 
performed. 


No card tests will be 
performed. 


Self explanatory 


Suggested Action 


None. 


None. 


Re-enter either ‘‘Y’’ or 
Seny??, 
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Execution Details 
““SCR”’ is followed by an initiating message. This message can take two forms: 


1. SCR parameters (Example 2), or 
2. names of star-files containing SCR parameters (Example 3). 


An SCR parameter is the name of an SCR subtest wanted by the user, followed by parameters to that 
subset. The available SCR subtests are: 


DCR 

CPU.IO 

MT.IO 

OTHER.IO 
The first parameter to each SCR subtest (that is, immediately following its name) must be a decimal 
integer specifying the number of times the subtest is to be performed. This number may not be ‘‘0’’. 


In the case of CPU.IO and of OTHER.IO, the number of iterations is the only parameter to the subt- 
est. 


odin oi SCR a oe < disk-name > < disk-name > 
<SCR test list > 


iteration = the number of iterations of the subsection. 


Where SCR test list is: 


<DCR test > CPU.IO < iteration > <MT.1O TEST > OTHER.IO <iteration > 


Where DCR test is: 


—~ DCR — ALL — < disk-name > ae <disk-name> aF 


or 


—— DCR —— < iteration > —— < disk-name > disk-name OPEN.FILES 


ara M 
Ss 


READ.CYLINDERS WRITE.INDEX < records > READ.RANDOM —— < sectors > 


records = The number of (data) records in the index file. 
sectors = The number of sectors to be read randomly. 
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Where MT.IO test is: 


—— =MT.10 —= < iteration > —- MT — < reels > ——— CS ——— <drN- > — RECORDS — < blocks > + 


reels = The number of magnetic tape reels to be tested. 
drives = The number of cassette drives to be tested. 
blocks = The number of records to be written. 


For MT.IO, the number of iterations must be followed by ‘‘MT’’ followed by the number of magnetic 
reels to be tested followed by ‘‘CS’’ followed by the number of cassettes to be tested. The total of 
reels and cassettes must be greater than 0 and no greater than 5. 


For DCR, the number of iterations must be followed by the name(s) of the disk(s) to be tested. There 
must be at least one and no more than two disk names, but the same System Disk identifier ‘‘0000000”’ 
are invalid. 


NOTE 
Omission of a disk name may result in the syntactic element immediately fol- 
lowing it being mistaken for a disk name; consequent error messages may 
therefore seem misleading. 


Each parameter following the disk name(s) is the name of a DCR subtest wanted by the user followed 
by parameters (if any) to that DCR subtest. The available DCR subtests are: 


READ.ALL 

OPEN. FILES 
READ.CYLINDERS 
WRITE.INDEX 
READ.RANDOM 


Repetition of DCR subtest names is invalid. 


DCR subtests OPEN.FILES and READ.CYLINDERS have no parameters. 


The DCR subtest name ‘““READ.ALL”’ must be followed by a parameter indicating the type of buffer- 
ing wanted: 


“M’? for multi-sector buffering, 
“‘S’? for single-sector buffering. 


The DCR subtest name ‘““WRITE.INDEX”’ must be followed by a decimal number specifying the num- 
ber of (data) records in the index file. The number 0 is invalid. 


The DCR subtest name “‘READ.RANDOM” must be followed by a decimal number specifying the 
number of sectors to be read. The number 0 is invalid. 
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If the user wishes all DCR subtests to be performed once only, with default parameters, he may follow 
“DCR” with ‘“‘ALL’’ followed by the disk name(s), omitting the DCR subtest names and parameters 
(Examples 4 and 6). 


If the user wishes all SCR subtests (including all DCR subtests) to be performed once only, with default 
parameters, he may follow ‘“‘SCR”’ with ‘“‘ALL”’ followed by the name(s) of the disk(s) to be tested 
in DCR, omitting the SCR subtest names and parameters (Example 5). 


Examples 
1. SCR 


2. EX SCR DCR | DISK1 DISK2 READ.ALL M OPEN.FILES READ.CYLINDERS WRITE.I- 
NDEX 100 READ.RANDOM 1000, CPU.IO 1, MT.IO 1 MT 1 CS 0 RECORDS 256, 
OTHER.IO 1 


5. SCR ALL DISK1 DISK2 

6. SCR DCR ALL DISK1 DISK2 
Note: Examples 2, 3, 4 and 5 produce the same effect. 
Default values are: 


number of iterations (for all SCR and DCR subtests = 1) 
MT.IO : MT = 1 
CS = 0 
RECORDS = 256 
DCR : WRITE.INDEX : <index.file size> = 100 
READ.RANDOM : <records> = 1000 
READ.ALL : <buffering> = M 


NOTE 
Example 6 has the same effect as was obtained under pre-3.04 release levels 
by executing DCR and making the appropriate replies to the various prompts. 


DCR (Disk Confidence Routine) 


The DCR subsection is used to establish a level of confidence in the ability of the CMS system hard- 
ware/software interface to service disk I/O. In doing so, it exercises the system as fully as possible 
and provides as much information as possible and practical about faults detected. With respect to hard- 
ware, DCR is designed to accommodate any CMS disk and attempts to maximize disk head movement, 
demands on the common electronics module, and demands on the directory search hardware. 


The DCR subsection includes five separate tests. These are: 


READ.ALL 
OPEN.FILES 
READ.CYLINDERS 
WRITE.INDEX 
READ.RANDOM 


All, or a subset of these, may be selected by the user in a given run of the subsection. Integrity of 


files already existing on disks being tested is maintained: except for one test, all I/O Operations are 
read only, and all files created by the subsection are closed and removed at or before EOJ. 
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For any run of DCR one or two disks may be used. The use of two disks is intended for dual disk 
drives and thus maximizes demands on the common electronics module. Both disks (when two are used) 
must be of the same capacity. 


READ.ALL reads all sectors on a disk, maximizing head movement by reading alternately from low- 
numbered and high-numbered sectors. The user may place greatest stress on the head by specifying 
that a system buffer with the capacity of one record be used. 


OPEN.FILES stresses the directory search hardware by opening and closing, without intervening I/O 
operations, up to 20 files on a disk. 


READ.CYLINDERS reads one sector from every cylinder on a disk, addressing sectors in such a way 
as to maximize head movement while ensuring that sectors are read from all tracks (all heads are acti- 
vated). 


WRITE.INDEX stresses the directory search hardware by writing an index file, of a length specified 
by the user, to disk and then reading the file back again, checking the data records for accuracy. 


NOTE 
This test requires a high proportion of execution time (approximately two 
minutes for a single file of 25 records; approximately 30 minutes for a single 
file of 500 records). 


READ.RANDOM stresses the head movement but under conditions more closely approximating those 
of a real-life environment than those of test 1, in that records to be read are randomly selected. Also, 


unlike test 1, the duration of the test does not depend on disk size as the user specifies the number 
of records to be read. 


Tests are always performed in the order in which they are listed above. 
CPUO 


For each iteration of the CPU.IO subsection, the programs SCR.MPL and SCR.COBOL are each 
executed once, each via a ZIP (DISPLAY). If a ZIP fails, the fetch value is examined. If the failure 
was because of a full mix, the ZIP is repeated until either it is successful or another fetch value is 
returned. For all other fetch values after a ZIP failure, the appropriate message from those listed above 
for DCR is displayed, the program name ‘‘DCR”’ being replaced by “SCR.MPL”’ or ‘‘SSCR.COBOL’’. 
Messages 12 and 13 do not apply to SCR.MPL or SCR.COBOL, as the ZIP is without PAUSE. 


As SCR.MPL and SCR.COBOL are executed via ZIPs without PAUSE, multiple copies of each (pro- 
duced by successive iterations of CPU.IO) may run concurrently. However, when control has been 
transferred to a copy of either SCR.MPL or SCR.COBOL, its status is not checked by SCR. 


The ZIP to execute SCR.MPL includes a 2-character initiating message which is the ASCII value of 
the current CPU.IO iteration number. 


SCR.MPL 


The 2-character initiating message is used as the last two characters in the 8-character FID, 
“SCR.M.cc’”’, of a random access disk file on the System Disk. This file is opened conditionally. If 
the open is unsuccessful, the following messages are displayed: 


‘FETCH VALUE = <hex no>” 
“SYSTEM DISK NOT AVAILABLE” 
“SCR.MPL COPY <2-digit no.> TERMINATED” 


2032801 fens 
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(where the <2-digit no.> is the 2-character initiating message) 


and goes to end-of-job. 


If the file is opened successfully, the following comparative expression is computed iteratively: 
(1+ 1)*5)*(I+ 1)*5))/(1+ 1)*5) = (1+1)*5 


where I is incremented by 1 from 0 to 50 and is equal to the ordinal number of the computation itera- 
tion. 


At each computation, if the expression is evaluated as false, the following message is displayed: 


“P1 COMPUTATION ERROR, I = <decimal no>’’ 


If the expression is evaluated as True, a fixed value for I is computed and output as the first two 
bytes of a 180-byte record. If the WRITE operation results in a conditional fail and the last two bytes 
of the fetch value are hexadecimal ‘‘0000’’, the WRITE operation is repeated. If the last two bytes 
of the fetch value on a conditional fail are not hexadecimal ‘‘0000’’, the following messages are dis- 
played: 


*““SCR.MPL COPY <decimal no>”’ 
(where <decimal no> is the 2-character SCR.MPL initiating message) and 
“FETCH VALUE = <hex no.>” 


If the WRITE operation causes an error, the MCP error message is the only message displayed. 


Immediately after a record is written, it is read back into memory and the first two bytes compared 
with the current value of I. 


If the READ operation causes a conditional fail and the last two bytes of the fetch value are 
hexadecimal ‘‘0000’’, the READ operation is repeated. If the last two bytes of the fetch value are not 
hexadecimal ‘‘0000’’, the following messages are displayed, as for the WRITE operation: 


*“SSCR.MPL COPY <decimal no>’”’ 
“FETCH VALUE = <hex no>”’ 


If the READ operation causes an error, the MCP error message is the only message displayed. If the 
comparison between the input value and I fails, the following message is displayed: 


“INPUT/OUTPUT MISMATCH, I = <decimal no>’’ 


After 51 compute-write-read-compare iterations have been performed, SCR.MPL displays the following 
messages: 


“SCR.MPL COPY <decimal no> TERMINATED” 

“WRITE CONDITIONAL FAILS = <decimal no>, 
WRITE ERRORS = <decimal no>.’’ 

“READ CONDITIONAL FAILS = <decimal no>, 
READ ERRORS = <decimal no> 


SCR.MPL then closes the disk file with RELEASE, and goes to end-of-job. 
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SCR.COBOL 


Using the initial values: 


A = 10 
B= 1 

C= .1 
D = 01 
E = 2 


SCR.COBOL calculates: 
X = (A+B) * (C—D)/(E*E) 


using the COMPUTE statement, and calculates the same expression in an alternative manner, using 
the individual arithmetic statements ADD, SUBTRACT, MULTIPLY and DIVIDE, assigning the re- 
sults to variable X1. The value X2 = -1 * X is also calculated. 


The values X, X1, and X2 are moved to fields of a line image, using the editing symbols : % Z B 
— * CR DB, and the line is printed by the first available printer on a page headed ‘‘PROGRAM 
CMTHS’’. Sub-headings are printed for each of the fields. 


The values X, X1, and X2 are calculated and printed five times, the values of A, B, C, D and E being 
multiniied hy 2 after each calculation. 


MALL psseese YF Say pay 8 


Each execution of SCR.COBOL should produce one printed page, as shown here: 


COMP. CALC, 


VALUE VALUE EDIT 1 EDIT 2 EDIT 3 EDIT 4 EDIT 5 EDIT 6 EDIT 7 


002475 002475 $ 24.75 $ 24.75 15 **24.75 $002475 **24.75CR $002475DB 
009900 009900 $ 99.00 $ 99.00 .00 **99.00 $009900 **99.00CR $009900DB 
039600 039600 $ 396.00 $396.00 .00 *396.00 $039600  *396.00CR $039600DB 
158400 158400 $1584.00 $584.00 .00 1584.00 $158400 1584.00CR $158400DB 
633600 633600 $6336.00 $366.00 .00 6336.00 $633600  6336.00CR $633600DB 


After the last line of the page has been printed, SCR.COBOL goes to end-of-job. 
MT .10 


For each iteration of the MT.IO subsection, a file is opened for output on each of the magnetic devices 
requested by the user. 


To each device on which a file was successfully opened, a file of the size specified by the user (or 
the default size of 256 records) is written. Each record is 120 bytes long and contains 60 fixed point 
values, where each fixed point value is the current record number. The current record is written to 
each of the open files before the record is updated. If the WRITE operation causes a conditional fail 
and the last two bytes of the fetch value are hexadecimal ‘‘0000’’, the WRIT. E is repeated. If the 
WRITE operation fails, causes a conditional fail and the last two bytes of the fetch value are not 
hexadecimal ‘‘0000’’, or if the WRITE operation causes an error, the following messages are displayed: 
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“SCR MT.IO; ITERATION <decimal no>:” 
‘“‘WRITE FAIL ON <device> FILE <file no> RECORD <record no>”’ 
“FETCH VALUE = <hex no>” 


and the file is half-closed. 


After output of all files has been completed, all open files are half-closed and re-opened for input. 
If an open fails, the following messages are displayed: 


“SCR MT.IO; ITERATION <decimal no>:”’ 
“FILE <file no> DID NOT OPEN FOR INPUT ON <device>”’ 
“FETCH VALUE = <hex no>.”’ 


All open files are read, the current record being read from all open files before the record number 
is updated. If the READ operation causes a conditional fail and the last two bytes of the fetch value 
are hexadecimal ‘‘0000’’, the READ operation is repeated. If the READ operation causes a conditional 
fail and the last two bytes of the fetch value are not hexadecimal ‘‘0000’’, or if the READ operation 
causes an error, the following messages are displayed: 


“SCR MT.IO; ITERATION <decimal no>:’? “READ FAIL ON <device> FILE <file no> 
RECORD <record no>” ““FETCH VALUE = <hex no>’”’ 


and the file is closed and purged. 


As each record of each file is input, the 60 fixed point values it contains are compared with the current 
record number. In the event of a mismatch, the following messages are displayed: 


“SCR MT.IO; ITERATION <decimal no>:’’ 
““WRITE/READ MISMATCH ON <device> FILE <file no>, RECORD <record no>”’ 


After all files have been input, all open files are closed and purged. 


The output-input operations described above are repeated for the number of MT.IO iterations specified 
by the user. 


OTHER.IO 


The OTHER.IO subsection of SCR is currently limited to the first printer available at execution, using. 
MPL Line Controls. 


Each iteration of the subsection outputs six pages of print, each print page containing 20 pairs of print 
lines. Pairs of lines are separated by a space line. Each of the first pair of lines contains 120 X’s, 
with spaces replacing X’s in the leftmost character positions of line pairs, the number of spaces being 
incremented by 1 for each pair of lines, as illustrated in figure 4-6. 


At the end of each iteration, the PRINTER file is closed with RELEASE and re-opened at the start 
of the next iteration. The number of iterations that are performed is determined by user input. 
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Figure 4-6. OTHER.IO Sample Printer Output 
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SQ (Squash Disk) 


When a disk unit is used extensively with a high degree of file activity involving creation and removal 
of files, then it is possible for the available space on the disk to become so fragmented that it is increas- 
ingly difficult to find enough space in one single area to satisfy requests for disk space. This results 
in a degradation of system throughput with an increasing incidence of ‘“NO DISK SPACE?”’ failures 
and extra time is needed to search through available areas. This situation is known as ‘‘checkerboard- 
ing’’ of the disk. In the extreme case each area of disk in use is separated by an available area, as 


shown in the diagram below. 


| data area # 3 


available 


The SQ utility is designed to eliminate checkerboarding of disk, either for the whole disk or part of 
the disk. This process is called ‘‘squashing’’ the disk and is accomplished by moving each data area 
in turn to the first available area at a lower address. If an entire disk is squashed, then all available 
areas are merged into one area at the high-address end of the disk, as in the next diagram: 


The options available within the SQ utility are: 


Squash of complete disk. 


All data areas are moved to successively lower addresses until only one available area is left (as 
in diagram above). 


Partial Squash 


Only data areas within a default section of the disk are moved to lower addresses within the sec- 
tion. 


Fast Squash 
The aim of a fast squash is to create an available area of disk of a requested size. Only those 


data areas are moved which will allow an available area of sufficient size to be created. 
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Economic Squash 


In this case, data areas are only moved if the gain in terms of available space justifies the time 
spent in movement of the data area. As an example, consider the following case: 


available #2 


where data area #1 is 100 units, data area #2 is 200 units and both available areas are 1 unit each. 
If available areas are merged, the available area gained would be 2 units. However, to acquire 
these 2 units, the 200 units of data area #2 would have to be moved. Therefore, an ‘‘economic 
squash’? would not move data area #2. In general terms, an economic squash will ignore small 
available areas that are interspersed in large data areas. However, in some cases an economic 
squash will have the same effects as a full squash. 


With all options of SQ, a further option is available to print a map of the entire disk in disk-address 
order both before and after squashing action. 


VERIFY 


FROM <addr > TO 


ALL 


< number > 


FAST 
SO ——— <disk-name > 


Note: the number is in the range 1 to 65535; the start-address and end-address are 6-digit hexadecimal 
disk addresses, for example, 000AB3, 01A375. 


When the SQ LIST option is requested, SQ opens conditionally a printer file so that the output will 
go to a printer irrespective of the system backup option. This prevents a printer backup file being 
opened on the disk being squashed. 
Examples: 
To perform an economic sGiast of disk PR2: 
SQ PR2 
To check the integrity of disk PR2: 
SQ PR2 VERIFY 
To perform a full squash of disk PR2 and list the disk map: 
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SQ PR2 ALL LIST 
To perform a partial squash to obtain 1000 sectors: 

SQ PR2 FAST 1000 
To perform a partial squash on sectors 0 through 512 of disk PR2: 

SQ PR2 FROM BEGIN TO 000200 
To perform a partial squash on sectors 512 through 4096 of disk PR2: 

SQ PR2 FROM 000200 TO 001000 
To perform a partial squash on sectors 4096 to the last addressable sector of disk PR2: 

SQ PR2 FROM 001000 TO END 
Before performing any function which involves physically moving data areas, the integrity of the disk 
is checked. Integrity involves analyzing disk assignment to verify that the entire area of the disk is de- 
scribed in the file directories and available table, checking the directories themselves and attempting 
to resolve anomalies (for example, missing areas or overlapping areas). Only after the integrity is 


verified are areas of disk physically moved. 


Certain areas of disk will not be moved in any circumstance. These are areas of disk currently marked 


as in use and any system log files. 


Output Messages 


Message 


VERIFICATION OF 
<diskname> COMPLETED 


—SQUASH COMMENCING 


SQUASH OF DISK 
<diskname> COMPLETED 


—SIZE OF LARGEST 
AVAILABLE AREA IS 
<number> SECTOR(S) 


-—TOTAL AVAILABLE 
SPACE IS <number> 
SECTORS IN <number> 
AREA(S) 


SQ HAS INFORMATION 
TO PRINT, ENTER Y IF IT 
HAS TO BE IGNORED OR 
N TO PRINT IT 


PREVIOUS EXECUTION OF 
SQ ON DISK <diskname> 
WAS ABNORMALLY 
TERMINATED WHILE 
MOVING FILE <filename> 
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Possible Causes 
SQ successful. 


Squash phase begins. 
SQ successful 


Self-explanatory. 


Self-explanatory. 


The LIST option has been 
specified in the initiating 
message but there is no 
printer available. 


System crashed or SQ was 
DS’ed during previous 
execution of SQ. 


Suggested Action 
None. 


None. 
None. 


None. 


None. 


Enter AX <mix-no> Y to 
continue without list or AX 
<mix-no> N after printer is 
made available. 


Check integrity of specified file. 


Message 


—THIS FILE MAY BE 
CORRUPT 


DISK <diskname> HAS 
MISSING OR 
OVERLAPPING AREAS 


—A LISTING OF DISK 
SPACE USE WILL BE 
PRINTED 


HARDWARE ERROR 
DETECTED ON DISK 
<diskname> WHILE 
MOVING FILE AREA TO 
SECTOR RANGE 
<address> — <address> 


HARDWARE ERROR 
DETECTED ON DISK 
<diskname> WHILE 
MOVING FILE AREA 
FROM SECTOR RANGE 
<address> — <address> 


HARDWARE ERROR 
DETECTED ON AN AREA 
OF FILE <filename> ON 
DISK <diskname> 


—THIS AREA WILL NOT 
BE MOVED 


DISK <diskname> NOT 
SQUASHED 


—NO SUITABLE AREAS IN 
SPECIFIED SECTOR 
RANGE 


—AVAILABLE AREA OF 
REQUESTED SIZE 
ALREADY EXISTS 


—AVAILABLE AREA OF 
REQUESTED SIZE 
CANNOT BE CREATED 


—SPECIFIED SECTOR 
RANGE IS BEYOND END 
OF DISK <diskname> 


—<diskname> IS NOT A 
PHYSICAL DISK 
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(continued) 
Possibie Causes 


Self-explanatory. 


There are areas on disk not 
referenced by the available 
table or the disk directory or 
areas referenced by both. 


Self-explanatory. 


The utility has encountered a 
parity error on the specified 
area on disk. 


The utility has encountered a 
parity error on the specified 
area on disk. File is not 
moved. 


The utility has encountered a 
parity error on the specified 
file. 


Self-explanatory. 


The utility cannot run. 


The utility cannot obtain the 
requested space in the 
specified area. 


Self-explanatory. 


There is no way to create the 
requested area. 


Self-explanatory. 


An attempt was made to run 
SQ on a pseudo disk. 


Suggested Action 


Check integrity of specified file 
and replace if suspect. 


None. Utility has corrected this 
situation. 


None. 


The utility left the area 
available. After SQ has finished, 
use CHECK. DISK to find the 
bad sector. Use XD to delete 
the sector. 


Check disk integrity after SQ 
has finished. 


Check disk integrity after SQ 
has finished. 


None. 


Look for the reason in the 
second message. 


Expand the range for SQ. 


None. 


None. 


Correct input and re-enter. 


Correct input and re-enter. 
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Message 


— DIRECTORY OF DISK 
<diskname> IS NO 
LONGER VALID 


—SPACE ON DISK 
<diskname> IS TOO 
FRAGMENTED TO 
SQUASH 


—HARDWARE ERROR 
DETECTED DIRECTORY 
OF DISK <diskname> 


-~CANNOT SEPARATE 
OVERLAPPING BAD AREA 
AND AREA OF FILE 
<filename> ON DISK 
<diskname > 


—TOO MANY FILE AREAS 
ON DISK <diskname> 
PLEASE TRY SQUASHING 
AN AREA OF THE DISK 


—CANNOT SEPARATE 
OVERLAPPING AREAS OF 
FILES <filename> AND 
<filename> ON DISK 
<diskname > 


— AREAS MISSING FROM 
<diskname>, PLEASE RUN 
SQ VERIFY 


—TOO MANY OPEN FILES 
OR BAD AREAS ON DISK 
<diskname > 


—PLEASE BACKUP FILES 
AND RE-INITIALISE DISK 


—SPECIFIED DISKNAME 
IS INVALID 


— PARAMETER 
FOLLOWING KEYWORD 
FAST IS GREATER THAN 
65535 


— PARAMETER 
FOLLOWING KEYWORD 
“TO”? OR “FROM” IS 
INVALID 
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(continued) 
Possible Causes 


The problems the specified 
disk are so great that SQ 
cannot clear them. 


There is insufficient space on 
disk for SQ to run. 


The utility has encountered a 
parity error on the directory 
of the specified disk. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


Seif-explianaiory. 


Self-explanatory. 


Self-explanatory. 
Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


Suggested Action 


Try to copy the files from the 
specified disk to another disk or 
to tape. Then re-initialize the 
disk. 


Use COPY and RM or 
UNLOAD to save files and 
create space for SQ to run. 


Specified disk cannot be used 
any more and must be 
initialized. 

Try to dump or copy files from 
disk. Disk must be re-initialized 
before re-use. 


Use SQ FROM/IO option to SQ 
an area of the disk. 


Try to dump or copy files from 
disk. Disk must be re-initialized 
before re-use. 


Run SQ <diskname> VERIFY. 


Close open files by bringing any 
running program to end-of-job. 
In case of bad sectors re- 
initialize the disk after having 
saved the required files. 


Backup files using COPY or 
DUMP. 
Correct input and re-enter. 


Correct input and re-enter. 


Correct input and re-enter. 


General Guidelines 


If the information contained on a disk is important always ensure that backup exists before attempting 
to squash it. 


Always run “SQ VERIFY” before running an actual squash. This will give an indication of the state 
of the disk. 


Do not allow disks to become too fragmented before squashing them. A full squash can be a 
process and can be avoided by running “‘SQ VERIFY” on a regular basis and running partial squash 
when the disk starts checker-boarding. 


“SQ VERIFY” is a means of checking the integrity of any disk and, if run on a reguiar basis, may 
help pinpoint sooner any degradation in hardware performance or system software bugs. For disks that 


This can help prevent catastrophic losses of information. 


NOTE 
It is strongly recommended that SQ, once loaded, is not DSed. 
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SYCOPY (Copy Library Tapes) 


The utility SYCOPY provides the user with a means of duplicating, comparing or merging library tapes 
(or cassettes) with multiple copy capabilities (except for the merging option). 


The initiating message has the following syntax: 


< integer > 


SYCOPY CPY 
CMP 


CCM 


IN 
"J t NAME < user-id > 
TAPE < tape-no > 
MRG 
| | —— SYSTEM——, | 


ae Fl oe NAME < user-id > an) 


OUT 


TEACH 


where <integer> = 1-7 (defaults to 1) 


The default-names for input tape is ‘‘IN’’ and for output tapes ‘‘TAPE.1” through ‘‘TAPE.7’’, except 
in MRG function where the input tape names are “SYSTEM”’ and ‘““UPDATE”’ and the output tape 
name is “‘OUT’’. All output tapes are locked after job termination. 


CPY 


CPY makes <integer> copies of a library tape (created with the LD utility) with no compare. At end, 
the output tapes are locked, and the input tape is released. 


Examples: 


To copy one input tape labelled ‘‘IN’’ to two output tapes, labelled ‘‘TAPE.1’? and ‘“‘TAPE.2”: 
SYCOPY CPY 2 


To copy one input tape labelled ‘““FRED”’ to one output tape, labelled ““FRED.OUT”’: 
SYCOPY CPY FI IN NAME FRED FI TAPE.1 NAME FRED.OUT 


CMP 
CMP compares <integer> tapes with one input tape. On completion, all tapes are reieased. 


For the FILEO00, the comparison works as follows: 
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— first records: only bytes 1-20 (byte 1 being the first) and bytes 28-38 are compared (check if 
library tape and number of files). 
— other records: only bytes 1-12 (filename) are compared. 


The record sizes of input and output tapes must be the same. This restriction does not apply to buffer 
sizes, which may be different for input and output tapes. 


Differences between the filesizes of the input tape and the output tape with which it is being compared 
will be detected; in this case, a comparison error for End-of-File or Not End-of-File will be displayed 
(see Output Messages). 


Examples: 


To compare one tape named ‘‘IN’’ with three tapes named ‘“‘TAPE.1’’, ‘““‘TAPE.2’’ and ‘‘TAPE.3”’: 
SYCOPY CMP 3 


To compare one tape named ‘‘FRED’’ with one tape named ‘“TAPE.1”’: 
SYCOPY CMPIFI IN NAME FRED 


CCM 


CCM performs CPY then CMP successively. On completion, the output tapes are locked and the input 
tape is released. 


Examples: 
To copy one input tape named ‘“‘IN’’ to three output tapes named “TAPE.1’’, ‘“‘TAPE.2”’ and 
“TAPE.3” and then to compare “‘IN’’ with ‘‘TAPE.1”’, ““TAPE.2” and ‘“TAPE.3”’: 
SYCOPY CCM 3 
MRG 


MRG merges two input tapes (called SYSTEM and UPDATE by default) to one output tape (OUT 
by default), then compares the merged tape with the original tapes. 


Duplicate files will be removed, with the UPDATE file taking precedence over the SYSTEM file. 
The files will appear on the output tape in the following order: 

— Duplicate Key Files (from second input tape) 

— Non Duplicate Files (from first input tape) 

— Remaining Files (from second input tape) 


The record sizes of the input tapes must be the same, but buffer sizes may be different. The buffer 
size of the first input tape will be used for the output tape. 


If more than one copy of the newly-merged tape is required, use CPY. 


When a comparison error occurs, the faulty tape is either purged (for CCM or MRG) or released (for 
CMP) and an error message displayed. Refer to Output Messages for possible error messages. 


Examples: 


To merge two input tapes named “SYSTEM” and ‘‘UPDATE”’ and output one tape named ‘‘OUT”’: 
SYCOPY MRG 
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To merge two input tapes labelled ‘‘A’’ and “UPDATE” to one output tape named ‘‘B’’: 


SYCOPY MRG FI SYSTEM NAME A FI OUT NAME B 


TEACH 


TEACH displays the syntax of the initiating message. 


Example: 
SYCOPY TEACH 


Output Messages 


Message 


<number> TAPE(S) 
COPIED 

<number> TAPE(S) 
COMPARED — NO ERROR 
<number> TAPE(S) 
COPIED AND COMPARED 
— NO ERRORS 


2 TAPE(S) MERGED — NO 
ERROR 


<number> TAPE(S) 
COMPARED 


<number> TAPE(S) 
DELETED 


<number> TAPE(S) 
COPIED AND COMPARED 


<number> TAPE(S) 
DELETED 


— <tapename> IS NOT A 
RECOGNISED LOAD/ 
DUMP TAPE 


UTILITY LIMIT REACHED 
WHEN RUNNING SYCOPY 


—RECORD SIZE 
MISMATCH 


INVALID CASE — SYCOPY 
ABORTED 


DISCREPANCY IN DUMP 
LEVELS 


END OF FILE REACHED 
NOT END OF FILE 
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Possible Cause 
Successful copy function. 


Successful compare function. 


Successful copy and compare 
function. 


Successful merge function. 


One or more, but not all, of 
the output tapes has been 


deleted. 


One or more but not all of 
the output tapes has been 


deleted. 


The specified tape is not 
created by a function of the 
LD utility. 


The number of files on the 
input tape for MGR exceeds 
65535. 


Compare had failed. Possible 
hardware problem. 


Error in SYCOPY. 


Compare had failed. 


Self-explanatory. 
Self-explanatory. 


Suggested Action 
None. 


None. 


None. 


None. 


None. 


None. 


None. 


None. Utility information. 


Re-run SYCOPY or other 
medium. 


Copy backup and re-run. 


None. 


None. 
None. 
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TAPELR (List Library Tape Directory) 


This utility allows the operator to print detailed information about the library tape files. Output will 
appear either on the line printer or the console printer. 


Tapes about which information is required are identified by ‘‘library-tape-name’’. More than one tape 
name may be requested during a single run of TAPELR. 


Format 
TAPELR library-tape-name 
Examples 


To print detailed information about the files on a tape called PRTAPE: 
TAPELR PRTAPE 


To print detailed information about the files on tapes called PRTAPE and ICTAPE: 
TAPELR PRTAPE ICTAPE 


Output Format 


Ten columns of information will appear for each library tape indicated. The column headings, the for- 
mat of the ‘values’? these columns contain and the significance of these ‘‘values”’ is as follows: 


Heading Value Significance 
FILE.NUMBER 6 digits Logical file number on tape. 
FILE NAME 12 characters File name. 

ACTUAL SIZE 7 digits Number of records in this file. 

MAXIMUM SIZE 7 digits Maximum number of records 
this file may contain. 

RECORD SIZE 5 digits Number of characters in each 
record. 

RECS/BLOCK 5 digits Number of records in each 
block. 

CREATED 5 digits Date file was created (Julian 
YYDDD) 

ACCESSED 5 digits Date file was last accessed by a 
program (Julian YYDDD). 

GENERATION NO. 3 digit 

FILE TYPE 8 characters See note below. 


Note: FILE TYPE will be one of the following: 
DATA — normal data file 
CODE — object program file 
KEY — key file 
SYSTEM — system file (for example, MCP, interpreters) 
SRCELANG — source language file 
SRCELIBR — source library file 
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Output Messages 


Message Possible Cause Suggested Action 
— HARDWARE ERROR The utility has encountered an Check integrity of the specified 
DETECTED ON PRINTER error on the specified disk. disk. 
BACKUP DISK <disk- 
name> 
- PRINTER BACKUP The printer backup filesize is Use SO PRBK ON <number> 
FILESIZE NEEDS TO BE too small. to increase filesize. 
INCREASED 
<tapename> NOT A The specified tape is not None. 
RECOGNIZED DUMP TAPE created by a function of the 

LD utility. 


Note: Refer to ‘“‘Common Utility Output Messages’’ for additional messages. 
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TAPEPD (Print Name of a Library Tape) 


This utility allows the operator to print the names of files found on a library-tape. More than one 
tape name may be requested during a single run of TAPEPD. 


Format: 


ibrary-tape-name 


—j 
» 
as 
to 
as) 
7) 


Examples: 
To print the names of files found on a tape called PRTAPE: 
TAPEPD PRTAPE 
To print the names of the files found on tapes called PRTAPE, ICTAPE and GLTAPE: 


TAPEPD PRTAPE ICTAPE GLTAPE 
Output format: 


For each tape requested, the following information in displayed: 


This message precedes the names of files found on each tape. The list itself contains 3 files per line. 
Output Messages 
Message Possible Causes Suggested Action 


<library-tape-name> NOT A_ This tape was not created by None. 
RECOGNIZED DUMP TAPE either the DUMP or 

UNLOAD function of LD 

utility. It is ignored by the 

TAPEPD utility. 


END TAPEPD End of Job message. None. 


Note: Refer to ‘““Common Utility Output Messages’’ for additional messages. 
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TL (Transfer Logs) 


At the beginning of any session, a number of ‘logging-files’ are created. The purpose of these files 
is to maintain a record of all the input/output transactions which occur during this period of time. 


For a fuller explanation of logging and its functions, see ‘“‘Logging in the 3.04 Release’’ earlier in this 
section. 


In order to produce an easily accessed file containing the data in all the primary files, they are consoli- 
dated into a single file. This is done automatically at warmstart, but the user can invoke consolidation 
of log files at any time by running the utility TL. 


Format: 


TL < file-name > RECOVER REM.DUP 


The utility determines the number of files to be consolidated. It then transfers each ‘““READY-TO- 
TRANSFER’”’ file, closing the consolidated file after each log-file has been transferred, until it reaches 
the file which was in an ‘‘ACTIVE”’ state at execution of TL. 


If the option ‘“RECOVER”’ has been specified, the utility enters the ‘‘ACTIVE”’ log file when it 
reaches it, and transfers all the entries up to the latest one, providing the file is not in use. If it is 
in use, the utility displays: 


“ILLEGAL USE OF RECOVER PARAMETER”, “ACTIVE FILE NOT CONSOLIDATED”’ 


and only consolidates “‘READY-TO-TRANSFER’”’ files. Otherwise, it stops consolidating when it 
reaches the ‘‘ACTIVE’’ file. 


All log-files transferred are left in a “TRANSFERRED” state. 


TL transfers maintenance entries to the secondary log file SYS-MLGjjjnn (jjj is the day number of 
the julian data, nn is a cyclic numeric progression in the range 00 to 99). 


TL will also transfer system messages to the secondary log file SYS-HLDjjjnn, only if logging method 
is non-cyclic. If the logging method is cyclic and TL has been zipped by SYS-SUPERUTL (this only 
occurs at warmstart), the system messages are transferred to a secondary log file called SYS-LOG- 
HOLD. 


Each time the MCP fills a log file, TL is zipped and transfers the contents of all the READY-TO- 
TRANSFER files, guided by information held in SYSCONFIG. If system messages are NOT to be 
logged, or they are to be logged in a cyclic manner, then TL only transfers maintenance entries. 


When TL is zipped by SYS-SUPERUTL, both options are included in the initiating message. When 
TL is zipped by the MCP, NO options are specified, therefore if a duplicate file condition arises, the 
operator must take action to resolve the situation. 


When entries are transferred to the maintenance log, the various input/output counts from the input 


files are merged with those contained in the output file. Therefore, when the output file becomes full, 
input/output counts in this file are valid for all the maintenance entries contained in it. 
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When the date changes on the system, the next time TL is zipped, the previous secondary log files 
will be closed with CRUNCH. 


Output Messages 
Message 


UNABLE TO ACCESS 
SYSCONFIG 


—TL IS UNABLE TO RUN 
WITH THIS VERSION OF 
SYSCONFIG 


LOG INFORMATION 
TRANSFERRED 


NO LOG INFORMATION 
TRANSFERRED 


—NO ACTIVE LOG FILE 
WAS FOUND 


—NO READY-TO- 
TRANSFER LOG FILES 
WERE FOUND 


SECONDARY LOG FILES 
WILL BE CREATED ON 


Ne 


THE SYSTEM DISK 


SECONDARY LOG FILE 
<filename> IS SMALLER 
THAN EXPECTED AND 
WILL NOT BE USED 


SECONDARY LOG FILE 
<filename> CREATED 


<filename> REMOVED 


—NO SPACE ON DISK 
<diskname> FOR 
TRANSFERRING LOG 
INFORMATION 


—FILE DIRECTORY ON 
DISK <diskname> IS FULL 


—FILE <filename> IS NOT 
A VALID LOG FILE 
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Possible Cause 


Another program is using 
SYSCONFIG 


Self-explanatory. 


TL successful. 


TL failed. The reason is 


given in the second message. 


Self-explanatory. 


Self-explanatory. 
Self-explanatory. 


Self-explanatory. 


Self-explanatory. 
The REM.DUP option was 


used. 
Self-explanatory. 


Self-explanatory. 


The specified file has not 
the filetype of a log file. 


Suggested Action 


Wait until the other program is 
finished then start TL again. 


Copy a suitabie version of 
SYSCONFIG to your system disk. 
None. 

See the second message for the 
reason. 


None. 


None. 
None. 


None. Utility continues. 


None. 
None. 


Create space by RM or 
UNLOAD and re-run the utility. 


Create space in the directory by 
removing files from disk. 


Check input for correct file 
name. 
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UNLOAD (LD — TAPE LIBRARY UTILITY) 


This function is part of the utility LD. UNLOAD provides the capability of copying files or groups 
of files from the disk specified by disk-name or, if no disk-name is specified, from the system disk. 
After each file is copied to tape, it is removed from the disk. 


Format: 


oe Beene ee UNLOAD UPDATED PRINT.DIR TO —— < tape-name > ——> 


< file-name > 


< disk-name > 


< family-name > 


NOTE 
A purged tape must be on line and ready for use by this utility. Purged tapes 
can be produced using either the PG or SN intrinsics on an on line and ready 
tape. 


UPDATED If UPDATED is specified, only updated or newly created files will 
be dumped, that is, files with the ‘Modified’ bit in the DFH set. 
(An LR listing will identify which files have the bit set.) 


PRINT.DIR If PRINT.DIR is specified, an accurate tape directory will be printed 
at the end of the dump. The list of files will be the same as in the 
directory at the head of the tape. For each file dumped, a list of its 
attributes will be printed. If any file was not dumped, the reason 
why will appear beside the name. When PRINT.DIR is specified, all 
messages of the form: 


‘*< file-name> DUMPED” 
‘‘< file-name> REMOVED’’ 


are suppressed. 


Displays will be limited to exception conditions, for example, if a 
file cannot be dumped or loaded for some reason. 


TO <tape-name> This is the name which will be given to the tape. 


FROM <disk-name> If the option FROM disk name is specified, the files will be dumped 
and removed from the disk named <disk-name>. If this option is 
not used, then the system disk is assumed. 


<file-name> <family- This is the file or family of files to be dumped to tape. Groups of 

name > files may be dumped by separating the file names or family names 
by a comma “‘,’’ or a space ‘“* ”’, 

<BOTH> If <BOTH> is specified immediately following a request to dump a 


key file then, provided that the pertinent data file is on the same 
disk, the data file following the key file on the tape will also be 
dumped. 
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Since the UNLOAD function is part of the utility LD, ““LD”’ is actually what appears in a mix mes- 
sage. To discontinue the UNLOAD function, ““DS <mix-number>/LD”’’ must be used. 


Examples: 


Example 1. 


Example 2. 


Output Messages 


To copy and remove all the files in the family named TEST from the 
system disk to a tape named TPTEST, the following initiating message is 
used: 

LD UNLOAD TO TPTEST TEST= 

To copy and remove all the key and data file pairs in the family MILK, 
which have been created or updated since the last time they were saved 
onto tape or disk, from the user disk DKMILK to the tape named 
TPMILK, the following initiating message is used: 

LD UNLOAD UPDATED PRINT.DIR TO TPMILK FROM DKMILK 
MILK= <BOTH> 


The addition of the keyword PRINT.DIR produces an accurate directory 
at the end of the dump. 


For output messages, refer to LD utility. 
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UPDATE (Disk File Update — B90 Only) 


This utility allows the operator to construct new disk files from existing files. ““CREATE’’ and 
‘““AMEND”’ use many similar features. 


Format: 


A 
L N : C < tabs “7 < file attributes > 
UPDATE < file-name > TO <new file-name > fo eeeenwes Ee 


where < tabs > is 


< tab position > 


TABSTOP 


and < file attributes > is 
(1) CRUNCH 
(1) 


FILESIZE < integer > 


< tab position > and <no. of records > are integers. 


The existing file must be a source or data file. Attributes such as Record Size will be taken from this 
file and used for the ‘‘new’’ file. 


Input may be specified as ‘‘A’’ (alphanumeric) or ‘‘N’’ (hexadecimal) (see CREATE utility for details). 


By specifying TABSTOP in the initiating message, UPDATE will set up tab positions coinciding with 
the end of the console line as well as any other tabs specified. 


The ‘‘number’’ option may be used to set ‘‘tab’’ positions for character input (see CREATE utility 
for details). 


The maximum number of records likely to be written to the new file may be specified using the FILE- 
SIZE option. If no total number of records is specified, the number will be taken from the old file. 


The CRUNCH option allows the operator to specify that the new file should occupy the minimum 
area of disk, but never be extended. 


The utility operates in three modes: ‘“‘Record Modify’’ (PK2), ‘‘Record Select’? (PK3) or ‘‘Record In- 
sert’? (PK4). 


PK1 PK2 PK3 PK4 PK5 PK6 
write last modify select insert delete EOJ 
and get 
next 
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OCK3 will display the current tab position anywhere in the record (except at the start of a record where 
the record number is displayed). 


OCK4 will output a display of the above options. If OCK4 is selected while in MODIFY, SELECT 
or INSERT mode, an asterisk (*) will be displayed preceding that mode. 


PK1 is used to write the last record processed to the new file and then select and print the next logical 
record from the-old file. The printout or screen will show the record number in the old file of the 
selected record, together with the next record number to be written to the new file. 


PKS is used to delete the last record printed by selecting and printing the next logical record from 
the old file without writing the last record to the new file. The printout will show the record numbers 
in the old file of the selected record, together with the next record number to be written to the new 
file. 


If PK3 is used, the required record is identified by logical record numbers using this format: 


RECORD 
ae eae es < number > —_—_ 


The “number” cannot be less than the last record obtained from the old file, or greater than the num- 
ber of records in the file. During the process of locating the required record, all records from and 
including the last record processed, pius one up to the one immediately prior to the selected record, 
will be copied from the existing file to the new file. When found, the selected record will be printed, 
with its record number in the old file followed by the record number that the next record written to 
the new file will take. “‘Record Modify’ (PK2) or “Record Insert’? (PK4) may then be selected. Note 
that a record inserted by Record Insert mode will be positioned after the selected record in the new 
file. Selecting Record ‘‘0’’ allows records to be inserted before Record 1 of the old file. 


PK2 is used to make alterations to existing records. This PK operates as PK2 in the CREATE utility 
(see CREATE for details). 


PK4 allows the operator to insert additional records in the new file after the last selected record of 
the old file. Input may be made in accordance with the specified tab stops. UPDATE will accept input 
only up to the next tab position. Fill characters will be displayed up to the next tab position if that 
tab is not reached. The utility prints the record number in the old file of the last record taken from 
the old file, and the record number in the new file, of the next record to be output, prior to accepting 
keyboard input. When all insertions have been made at a particular point in the file, an available PK 
may be pressed to select the next mode or terminate the utility. , 


NOTE 
To insert a record at the beginning of a new file, Record **0’? should be se- 
lected in Record Select Mode, prior to Selecting Record Insert Mode. 


Default tab positions have been selected to allow a maximum number of characters to be entered on 
one line. 


Tabs may be selected manually in addition to the default tab positions. 
Default tab positions for UPDATE are as follows: 


(source or alphanumeric) : 101 201 301 401 
(data hexadecimal) : 56 101 151 201 251 301 351 401 451 
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Examples: 


UPDATE FILEA TABSTOP TO FILED 101 201 301 401 (source file) 
UPDATE FILEB TABSTOP 151 200 TO FILEF 101 151 200 201 (alphanumeric input) 
301 401 
UPDATE FILEC N TABSTOP 46 420 TO FILEG 46 51 101 151 (data hexadecimal) 
201 251 
301 351 401 420 
451 


If the input file-name (OLD.FILE) is the same as the output file-name (NEW.FILE), the old version 

of the file will be removed and the generation number of the new version of the file will be set to 

one more than that of the old version. 

Examples: 

To update a source file called ‘‘APFILE”’ of record size 40 bytes into a file called ‘‘APFILE2”’: 
UPDATE APFILE 5 10 15 20 TO APFILE2 


The utility will illuminate PK1 and PK6. By pressing PK1, next sequential record will be selected and 
printed. 


As the utility is already in the Record Select Mode, by typing a record number, the specified record 
number and its contents are printed. 


4 4 ABCDEFGHIJKLMNOPQRST 


Note that the first ‘‘4’’ is the sequence number in the old ‘‘APFILE’’ and the second ‘‘4’’ is the se- 
quence number in the ‘‘APFILE2’’ file. 


At this point, the following PKs are available for selection: 
PK1 — select next sequential record and print 
PK2 ~— modify the selected record 
PK4 — insert new record after selected record (that is, ‘‘4’’) 
PK5 — delete the last selected record by selecting next record 
PK6 — terminate the utility 

To replace characters within a selected record, press PK2 and type the replacement: 
D:ZZZZ: OCK1 

resulting in: 
4 4 ABCDZZZZIJKLMNOPQRST 

To insert characters within a selected record, type: 


Z:XXXXXX: OCK2 


resulting in: 
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4 4 ABCDZXXXXXXZZZOPQRST 


To insert a record after record 7 of the existing file, press PK3 (Record Select Mode) and type a record 
number: 


7 OCK1 


Note: At this point, the record selection number given cannot be less than the last selected record, 
for example, records from 1 through 3 cannot be selected. In this example, records 5 to 6 are aiso 
copied to the new file. 


Press PK4 (Record Insert Mode). The utility will print the last selected record number on the left and 
the next record number after that, and allows the operator to key in the record to be inserted. 


7 8 AAAAAA 
The record inserted will be numbered 8 in the file ‘““APFILE”’ and will contain ‘“‘AAAAAA’’. 
Output Messages: 


Refer to the section on the ‘““CREATE”’ utility for output messages. 
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WL (What Log File) 


This utility allows the operator to determine the number of log files present and their status. 


Format: 
WL 


The WL utility determines which log files are present (from information contained in SYSCONFIG), 
and their states. WL displays this information in the following way: 


File Name File State 

SYS-LOG-01 < status > 

SYS-LOG-02 <status > 

SYS-LOG-03 < status > 

SYS-LOG-04 < status > 

BACKUP FILE(S) ON <disk name> 
SYS-MLGjjjmm ACT. <integer> RECS. 

MAX. <integer> RECS. 
SYS-HLDjjjhh ACT. <integer> RECS. 

MAX. <integer> RECS. 


The file SYS-HLDjjjhh will only be present if Non-cyclic SPO logging is active. 


<integer> is the number of records, or may be replaced by one of the status values if the relevant 
file falls into one of the categories. 


<status> may have one of the following values: 


< status > Description 
INVALID This indicates that the relevant log file is not in a recognized state, 

possibly due to some sort of corruption. 

ACTIVE This log file is being used by the MCP. 


READY TO TRANSFER The MCP has filled this primary log file and TL is required to 
transfer the Maintenance entries to SYS-MLGjjjmm, and System 
message entries, if Non-Cyclic SPO logging is active, to SYS- 


HLDjjjhh. 

TRANSFERRED TL has transferred the Maintenance entries to SYS-MLGjjjmm, and 
System message entries, if Non-Cyclic SPO logging is active, to SYS- 
HLDjjjhh. 

NEXT ACTIVE The MCP has cleared this primary log file ready for use. 

NOT USED This log has not been used yet. 

NOT FOUND This log file should be present, due to the information contained in 
SYSCOMFIG, but cannot be found on the disk. 

IN USE This log file is in use, by another program. 


4-260 


nn 


Output Messages 


Message Possible Cause Suggested Action 
~ UNABLE TO ACCESS Another program is using Wait until the other program is 
SYSCONFIG SYSCONFIG finished then start WL again. 
— WL IS UNABLE TO Seif-expianatory. Copy a suitable version of 
RUN WITH THIS VERSION SYSCONFIG to your systm disk. 
OF SYSCONFIG 
HARDWARE ERROR The utility has encountered Copy a suitable version of the 
DETECTED WHILE a parity error on the SYSCOMFIG file to the system 
READING SYSCONFIG SYSCOMFIG file. disk and re-start the system. 


NOTE: Refer to ‘“‘Common Utility Output Messages’’ for additional aid. 
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XD (Delete Bad Disk Sectors) 


This utility allows the disk directory to be marked such that selected portions of the disk will not be 
used. The utility will normally be used after recurrent errors with the message: 


DK...ERROR 


where the dots indicate further information. Refer to section 7, MCP Output Messages, for the fol- 
lowing numbered messages: 


2 PARITY ERROR 

3 TIMEOUT ERROR 

4 ADDRESS ERROR 

45 PARITY ERROR (fatal to program) 
46 TIMEOUT ERROR (fatal to program) 
47 ADDRESS ERROR (fatal to program) 


The further information will indicate the disk address at which the failure occurred. 
The utility is initiated as followed: 


Format: 
XD disk-name address length 


The disk-name is the disk-id of the disk from which sectors are to be deleted. The area to be deleted 
is given in hexadecimal by the starting address and length. 


Example: 
To delete 64 sectors starting from hex 395F from disk PR2B: 


XD PR2B 395F 40 


NOTE 
The specified sectors must not be in use as part of a file. The area must be 
made available by first removing any file if necessary. 


Warnings 


Once sectors are deleted via XD from a disk, they can be restored to use only by a disk initialization. 
Do not therefore XD a larger area than required. 


As XD alters the disk directory, do not run any other programs with it. 

Do not execute XD from the same disk as the one from which sectors are to be deleted: for example, 
it is recommended that XD is always executed from the system disk and always deletes sectors from 
a user disk. 


Output Messages 


Refer to “‘Common Utility Output Messages’’ for additional messages. 
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Message 


@length@ SECTORS FROM 
@address@ DELETED 


DISK disk-name FOR XD 
NOT AVAILABLE 
PLEASE RUN SQ ON DiSK 


disk-name 


AVAILABLE TABLE FULL 
— ENTRY @address@ 
@length@ LOST 


RANGE FROM SECTOR 
@address@ NOT DELETED, 
NOT AVAILABLE 


DISK <disk-name> IS NOT 
A PHYSICAL DISK 


Possible Causes 
Successful termination of XD. 


Specified disk is not available. 


Available table is full and 
available entries are lost. 
SYSMEM will be opened on 
the specified disk with 
otheruse LOCKED. 


No entries left in available 
space table for XD to 
complete properly. 


Only the part of the area 
specified for deletion is 
available. The utility will 
remove the available area 
only. 


The sector address specified is 
greaier than the address of 
the last physical sector on the 
disk. | 


The specified disk is a 
pseudo-disk. The utility will 
go to end of job. 


Suggested Action 


None. 
Check input: make disk ready. 


un SQ. 


The disk may stiii be used, but 
a KA will indicate some sectors 
which cannot be accessed; these 
may only be retrieved by 
initializing the disk. 

None. 


None. 


None. 


Note: Refer to “Common Utility Output Messages’’ for additional messages. 
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SECTION 5 
THE SORT/MERGE 


INTRODUCTION 


This section describes the capabilities of the SORT facility. There are two modules: the sort itself, 
known as the ‘‘sort intrinsic’’ (filename SORTINTRINS), and an interface to this intrinsic which al- 
lows the user to specify particular sorts and merges. The latter module is sometimes called ‘‘the sort’’, 
but is more properly called the ‘“‘sort language processor’ (file name SORT). The sort intrinsic is imple- 
mentation-dependent, as it uses specific hardware features where possible (although output messages 
are standardized), while the sort language processor is a CMS common item. 


This section first describes the user interface to the sort, and then covers the various facilities in some 
detail. 


The interface to the sort from COBOL programs is described in the COBOL language reference man- 
ual. 


GENERAL FEATURES 
The following capabilities are provided: 


The records within a file may be sorted on a series of specified keys, each key ascending or descending, 
using a regular sort or an in-piace sort. 


A tagfile (suitable for use as an ADDROUT file in RPG or for limited access in COBOL) may be 
created from a file using a series of keys, each ascending or descending. 


A key file (suitable for full indexed access) may be created using a specified unsigned key (ascending 
only), with an optional check for duplicate keys. 


A number of files may be merged using a series of keys, each ascending or descending. 


The regular and index sort intrinsics are able to sort files up to the maximum allowable size in CMS, 
which is 1,048,560 records. 


The inplace intrinsic has a B 90 implementation limit of 400,000 records. 
The merge intrinsic will produce an output file of up to 1,048,560 records. 
The memory required for a sort is calculated dynamically, with a default size of 15 K bytes. 


The workfile buffer default size for index sorts and regular sorts is 720 bytes. 
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INVOKING THE SORT 


The sort can be executed in three ways: 


1. Entering the name SORT with the details for the sort in the initiating message. 
for example, SORT FILE IN INFILE (DISK) OUT OUTFILE (DISK) KEY (1 12) 


2. Entering the name SORT with the details for the sort described in a starfile. 
for example, SORT *SORTTHISFILE 


3. Entering the name SORT preceded by the datacomm control character from a datacomm termi- 
nal with TD 830 capabilities, in which case an interactive version of SORT will be started, for 
example, $SORT. 


If the sort specification is given in the initiating message, the message may not be longer than 255 
characters. If the sort specification is zipped from a user program, the message may not be longer than 
716 characters. If it is not possible to specify a complex sort within these limitations, a starfile should 
be used. 


If a required starfile is not present, the non-interactive SORT displays 


FILE <filename> UNAVAILABLE ON (SYSTEM) DISK 
FIX AND REPLY ‘‘OK”? ELSE <NULL> 


and waits on ACCEPT. 
There are two alternative responses: 


1. Make the <filename> available and enter AX <mix-no> OK 
or 
2. Cause SORT to go to end-of-job by entering AX <mix-no> 


If specification statements are given in the initiating message, control characters such as carriage return 
and line feed are treated as space characters. 


If the name of a starfile is entered without a preceding diskname and the starfile name is not longer 
than seven characters, the file will be searched for first on cards, then on cassette and then on the 
system disk. If the name of the starfile exceeds seven characters, the file will be searched for on the 
system disk. 


A starfile on a cassette must be created using the COPY utility. Files created by the LD utility are 
not suitable. 


A starfile on disk must be of filetype source or data. Use FILEUTL or CMSCANDE to create them. 
A starfile cannot be accessed by SORT if the file is in use by another program. 
If SORT is to be started on a datacomm terminal, the terminal must be a TD 830 capable device. 


SORT can run with either a GEMCOS interface or a shifted TMCS interface. See the INTERACTIVE 
SORT later in this section for details. 


THE SORT LANGUAGE 


The specification for a sort consists of three statements: 


1. The FILE Statement 
2. The KEY Statement 
3. The USER-OPTION Statement 


< key.statement > < user.option.statement > 


There must be one file statement, one key statement, and, optionally, one or more user-option state- 
ments, in any particular sort invocation. All keywords are reserved: that is, they can only be used in 
the place specified below and cannot be used for other purposes such as filename. 


The main railroad diagram is: 


SORT —— < file.statement > 


The File Statement 


This consists of two parts: the first describes the input file(s) and the second describes the output file. 
Multiple input files are used only for the merge, which is specified as a user-option (see later). A sort 
must have only one input file; a merge may have up to 16 input files. 


mea FiLE -—— 


< mfid >/ < fid > —( — DISK PURGE < recordsize > < records per block > ) 


>— IN 


eee KEYFILE 
>— out + <mfid >/+ < fia > — ( TAGFILE )4 


DISK < recordsize > < records per block > 


The parentheses ‘‘(’? and ‘‘)’? may be replaced by the characters ‘‘<’’ and ‘‘>”’ respectively. 
Rules for the file statement are as follows: 


The medium for the specified input file(s) and output file is indicated by the keyword DISK. The ab- 
sence of a disk-name (mfid) indicates the system disk. DISK refers to any kind of disk-device. The 
input file for a tagfile or keyfile creation must be on disk. 


The PURGE option indicates that the input file(s) are to be purged after use. 


The record size and records-per-block values are numeric values. When the input medium is DISK, 
the record size and records-per-block may be omitted. For a merge specification, input disk file descrip- 
tions with record size specifications may be interspersed with descriptions without such specifications. 
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If the records-per-block is omitted and record size is given, a blocking factor of 1 is assumed. 
In all cases (except an index sort), input and output files must have the same record sizes. 


The values of record size and records-per-block may be omitted for output files. For a sort, the values 
assumed are those of the input file. For a merge, the values assumed are those of the first specified 
input file. 


For a keyfile creation sort, the output specification enclosed in parentheses must be the single word 
KEYFILE. The output will be on disk and record and block sizes are not user definable. 


For a tagfile creation sort, the output specification enclosed in parentheses must be the single word 
TAGFILE. The output will be on disk and record and block sizes are not user definable. 


The Key Statement 
This statement defines the record key(s) that are used for the sort or merge. 


A number of keys may be specified, each key description being enclosed in parentheses. The first key 
will be the major key and additional keys will be minor keys of decreasing significance. 


Railroad diagram: 


< ALPHA > 
<UA> 
< NUMERIC > 


<UN> 
<SA> 
<SN> 


to < ASCENDING > cass 
<A> 
< DESCENDING > 


<D> 


<SSA > 


KEY ( < location > < length > 


The ‘‘location’”’ is a numeric value specifying the position of the key relative to the start of the record, 
in 4-bit units. The first 4-bit unit has a location of 1. The key location is given by the position of 
the left-hand 4-bit unit in the key (which, depending on the key format), may be a character or a sign. 
The key should start on a byte boundary unless a record sort with a numeric key is performed. 


The ‘‘length’’ is a numeric value specifying the key length, in 4-bit units. This must include the sign, 
for signed keys. 


The keywords ASCENDING and DESCENDING determine the order of collation. These keywords 
may be abbreviated to A and D respectively. If omitted, the default is ASCENDING. A keyfile sort 
can only be in ASCENDING order. 


The format of the key is specified by one of the following keywords: 


ALPHA or UA — unsigned 8-bit alphanumeric 
NUMERIC or UN — unsigned 4-bit numeric 
SA — signed 8-bit alphanumeric 


nett 


SN — signed 4-bit numeric 
SSA — 8-bit alphanumeric with separate sign 


The default is ALPHA. 
For a signed key, the position of the sign is specified by one of the following keywords: 


— right-hand (least significant) end of key 
left-hand (most significant) end of key 


mF 
| 


The default is L. 
For a description of key types and sign zone interpretation, see later under ‘‘KEYS’’. 
The User-Option Statement 


These statements have three functions: 


1. To specify which function is required. 


2. To tailor a sort or merge to the particular machine configuration (for example, memory, printer 
availability). 
3. To add comments. 


The user-option statements are optional; if more than one are used, they may appear in any order 
relative to each other or to the file and key statements. 


Railroad diagram: 


INDEX 
IN PLACE NO DUPLICATES 
MERGE DUPLICATES 


SYNTAX 1 
NO PRINT 1 
NO DISPLAY 1 
COMMENT <comments > 1% 


FILESIZE <no-of-records > 1 
MEMORY < memory size > 1 
WORKDISK < disk-name > 1 


The type of sort is given by one of the keywords INDEX, INPLACE, or MERGE. If one of these 
does not appear, a regular full record sort is assumed. The keyword INDEX specifies the creation of 
a keyfile or tagfile, depending on the output file details (see FILE statement). The keyword INPLACE 
specifies a full record sort using a minimal amount of disk work space. The keyword MERGE specifies 
a merge of several input files. 


The keyword SYNTAX specifies that a check on the correctness of the sort statements is to be made 
without the sort actually being performed. 
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The keyword NOPRINT, if used in a starfile, stops the listing of the sort statements on the printer. 
If used, this keyword should be the first entry. If the statements are input via the SPO, they are not 
printed and so this keyword is not required in this case. The NOPRINT option also affects the printing 
of error and warning messages (see later). 


The keyword NODISPLAY controls the display of messages on the SPO during the sort. This option 
can be used both in initiating messages and from file-oriented statements. It suppresses startup and 
termination messages. It does not affect the display of error and warning messages. Error-and warning- 
free sorts and merges will show no SPO activity if this option is used. 


The keyword NODUPLICATES specifies that duplicate keys are not allowed in a keyfile creation. The 
keyword DUPLICATES specifies that duplicate keys are allowed in a keyfile creation. Both options 
are valid only when creating a keyfile. If neither is specified, the default is NODUPLICATES. 


The keyword COMMENT introduces comment text. The end of the comment text is either the end 
of the input of the end of a record if the input comes from a starfile. Comments may appear between 
user-option statements and between file descriptions and key descriptions. 


The keyword FILESIZE provides the following capabilities: 


Specification of sort disk work space where the input file is not on disk (this use is not required 
if the input is from disk). 

Specification of maximum size of the output file if on disk. 

Allowance for future expansion of the output disk file where the sort/merge will not by default 
create a large enough file. 


This keyword should be followed by a number giving the specified maximum number of records. For 
non-disk output files, the value is used for optimization purposes. If not used, default values are as- 
sumed where necessary. This option is not applicable to the inplace sort or to keyfile or tagfile 
creations. 


The keyword MEMORY specifies the amount of non-overlayabie work area to be used by the sort. 
This option is not applicable to the merge or to the inplace sort. If this is not enough for a successful 
sort, then this option is overridden. The memory size is in bytes; for example, MEMORY 1024. 


The keyword WORKDISK enables the regular sort to utilize disk space in an efficient manner. It is 
not applicable to the merge or inplace sort. When the work-disk is specified, the sort locates up to 
half the work space on that disk, with the rest on the system disk. If this option is not used, but the 
input or output file is resident on a user disk, the work space is shared between that disk and the 
system disk. In all other cases, the work space is located entirely on the system disk. The named disk 
may be any type of disk applicable to the system in use. 


Examples: 


To sort the system disk file INP.FILE using the key starting at character 5 of length 3 characters, 
creating a system disk file OUT.FILE: 


SORT FILE IN INP.FILE (DISK) OUT OUT.FILE (DISK) KEY (9 6) 


To create a keyfile OUTKEY.FILE on disk PR2 from a data file INP.FILE1 on disk PR2, using a 
5-byte key starting at the first byte: 


SORT FILE IN PR2/INP.FILE1 (DISK) 
OUT PR2/OUTKEY.FILE (KEYFILE) 


KEY (1 10) 
INDEX 


COMMENT DUPLICATES NOT ALLOWED 


To merge the three system disk files FILE1, FILE2 and FILE3 into an output file MERGE.OUT: 
SORT 


FILE IN FILE] (DISK) FILE2 (DISK) FILE3 (DISK) 
OUT MERGE.OUT (DISK) 

KEY (5 10) 

MERGE 
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INTERACTIVE SORT 


The SORT utility may be started from a datacomm terminal by entering <ncc> RN SORT, where 
<ncc> is the network control character. The datacomm terminal must be a TD 830 capable device. 


Once started, the utility displays the first screen called ‘‘ROOT’’. On this screen the utility shows all 
the available facilities; 


1: REGULAR SORT Creates a new ordered output file. 

2: INPLACE SORT Reorders the input file (no new file created). 

3: KEYFILE SORT Creates a CMS keyfile (index contains key). 

4: TAGFILE SORT Creates a CMS tagfile (no keys in index). 

5: MERGE Merges up to 16 ordered input files. 

6: RUN STAR FILE runs a previously saved sort. 

7: HELP Provides assistance with SORT screen and gives extra information 
about the current screen. 

8: EXIT Terminates the sort. 


The user is requested to enter a selection. Depending on the selection made, the utility will display 


th 
anoiner sereen 


If 1 (REGULAR SORT) or 2 (INPLACE SORT) is selected, the utility will display a screen on which 
the key and file specification may be entered. From this screen it is possible to request a second screen 
to enter more key specifications. After this screen, there may be a third screen to enter any user op- 
tions. 


If 3 (KEYFILE SORT) is selected, the utility will display a screen on which the required key and file 
specifications for the keyfile to be created may be entered. After this screen, there may be a second 
screen to enter any user options. 


If 4 (TAGFILE SORT) is selected, the utility will display a screen on which the required key and file 
specifications for the tagfile to be created may be entered. After this screen there may be a second 
screen to enter any user options. 


If 5 (MERGE) is selected, the utility will display a screen on which the first three file names and the 
key specification for the merge may be entered. If more than three files or more than one key specifica- 
tion are required the utility will display additional screens to enter the other names and key specifica- 
tions, or to enter any user options. 


If 6 (RUN STAR FILE) is selected, the utility will display a screen on which the name of the starfile 
to be created may be entered. On transmitting this screen with a sort command in the command selec- 
tion, the utility starts searching the requested star file and executes the sort. 


If 7 (HELP) is selected, the utility will display a screen with additional information about the SORT 
utility. 


NOTE 
All other screens also have HELP screens to supply additional information 
about the current screen. 


If 8 (EXIT) is selected, the utility goes to End-Of-Job. 
On all screens except the first, there are command selections requested. The possible commands with 


their explanations are: 
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1. HELP gives additional information about the options on the current screen. 
2. Not available. 
3. CONTINUE validates the input on the current screen and, if correct, it displays the next screen. 


4. GO BACK. If the 
non-help screen. It saves the input on the current screen but does not validate it. 


5. SORT validates the input on the current screen and if correct and all necessary input has been 
provided, the utility zips the intrinsic. 


6. SAVE displays a screen on which the name of a starfile to be created may be entered. The 
input on the current screen is not validated. 


7. SORT & SAVE validates the input on the current screen and if correct and all necessary input 
has been provided, a screen is displayed on which the name of a starfile may be entered. Then 
the utility zips the intrinsic. 


8. EXIT returns the utility to the ROOT screen. 


NOTE 
If a screen is disturbed, it may be recalled by entering ‘“RECALL’’ in the 
top left corner of the screen and then transmitting. 


2032801 6 


FUNCTIONAL DESCRIPTION 
The five functions of the sort are described here: 


1. Regular record sort. 
2. Inplace record sort. 
3. Keyfile creation. 

4. Tagfile creation. 

5. File merge. 


Regular Record Sort 


All the records contained within the specified input file are ordered using one or more keys. Deleted 
records (see later) are not included in the output file. See later for details of the keys. Refer to figure 
5-1 for an example of a regular record sort, where the key is starting in byte 3 and is five characters 
long, and the sort is in ascending order. The X’s refer to any other characters. 


RECORD 
NUMBER 


003 6/|x x x |x x|3 2 4 0 o|x x x| 


DATAFILE DATA FILE 
INPUT OUTPUT 


Figure 5-1. Regular Record Sort 


The input file must be wholly contained on one hardware type, although it may be a dual-disk file. 
No other programs may write to this file during the execution of the sort. 


The sort uses non-overlayable memory during execution. The amount is calculated according to the 
input file and key sizes. The amount may be specified as a user option, in which case the specified 
amount is used unless it is less than enough for a successful sort. In the latter case, the specified value 
will be overridden. 
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The sort uses disk work space, of up to 2.2 times the size of the specified input file. For the location 
of the work disk space, refer to the WORKDISK user option (see earlier). This work space is returned 
to the system at end-of-job. 


Inplace Record Sort 


This is the same as the regular record sort, except that the records are sorted within the input file. 
No new output file is created. The time taken is substantially greater than a regular sort, for the same 
input specifications. If deleted records are present in the file before the sort, they are removed: hence 
the number of records in the file may decrease after it has been ordered. 


The inplace sort uses non-overlayabie memory during execution. The size of this area cannot be 
specified at initiation. 


The input file must be on disk. No other programs may access this file during execution of the inplace 
sort. The output file must be the same as the file specified for input. 


If a particular system does not implement an in-place sort, a regular sort will be performed instead. 


The inplace sort uses disk work space, of 0.2 to 0.3 times the size of the input file. When the input 
file is resident on a user disk, up to one-half of the work space is located on that disk, otherwise all 
work space is located on the system disk. This work space is returned to the system at end-of-job. 


Keyfiie Creation 


A new file (the ‘‘keyfile’’) will be created containing one record for each record of the input file (the 
‘data file’). The keyfile is sorted in order of the specified keys, and each keyfile record contains the 
key and a pointer to the corresponding record in the data file. Any deleted records in the data file 
are not referenced in the keyfile. Note that the records in the data file are not re-ordered and deleted 
records in the data file are not removed. Refer to figure 5-2 for an example of a keyfile creation, where 
the key is starting in byte 3 and is five characters long, and the sort is in ascending order. The X’s 
refer to any other character. 


Duplicate keys are not allowed unless specified (see the user-option statements DUPLICATES and NO- 
DUPLICATES). If they occur, then the record number is displayed on the SPO for each such occur- 
rence, and the sort will continue but the output keyfile will be purged at end-of-job. 


The keyfile creation uses disk work space, of up to 2.2 times the size of temporary file created by 
the sort in this case. This file is large enough to contain one record with the key value and record 
number for each record in the input file. For the location of the work disk space, refer to the WORK- 
DISK user option (see earlier). This work space is returned to the system at end-of-job. 


Certain key values are not allowed during a keyfile creation. The key must not consist of all binary 
zeros, or must not contain any byte whose value is hex FF. If such a key is encountered, the record 
number is displayed on the SPO, and the sort will continue but the output keyfile will not refer to 
this record in the data file. 


Tagfile Creation 


A tagfile creation is similar to a keyfile creation, except that the output file contains only the record 
pointers, and not any key values. The tagfile records, however, are ordered in key value order, as 
specified by the sort. Any deleted records are not referenced in the tagfile. Refer to figure 5-3 for an 
example of a tagfile creation, corresponding to the keyfile creation in figure 5-2. 
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RECORD 


NUMBER 
1 
2 
3 
4 
5 
: 
. 


DATA FILE KEYFILE 


| iNPUT OUTPUT | 


Figure 5-2. Keyfile Creation 


RECORD 
NUMBER 


x x[s 20 ofe xx 


DATA FILE TAGFILE 
INPUT OUTPUT 


Figure 5-3. Tagfile Creation 


A tagfile is a null keyfile. It is suitable for use as an ADDROUT file in RPG, and for limited indexed 
access in COBOL (the tagfile is read sequentially). 
Disk space requirements are the same as for keyfile creation. 
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Merge 


The merge merges up to 16 input files, using one or more specified keys, producing one output file. 
Deleted records in the input files are not included in the output file. If there are duplicate keys values, 
the order in which they are placed in the output file is given by the order in which the input files 
are specified. 


Each input file must be wholly contained on one hardware type, although it may be a dual-disk file. 
No other programs may write to these files during the execution of the merge. 


Each input file must have the same record size and the same position and length for each key. Each 
file must be already correctly ordered on the specified keys. If this is not the case, the merge will ter- 
minate prematurely after displaying a message on the SPO. 


Refer to figure 5-4 for an example of a merge of two files, with a key starting at byte 3 which is 
five characters long. The X’s and Y’s refer to any character. 


The merge uses non-overlayable memory during execution. The size of this area cannot be specified 
at initiation: it will be approximately equal to the sum of the block sizes of the input files and the 
output file. 


The merge does not use any disk work space. 

Details of Sort Keys 

A “key”? is the field within each record that is used for sorting or merging. If severai distinct fieids 
within a record are specified, then each field is a separate key. The relative order of importance of 


the keys is determined by the order in which they are specified. Figure 5-5 illustrates this with a two- 
key sort, using the KEY statement. 


KEY (5 6 ALPHA) (15 2 DESCENDING ALPHA) 
The X’s indicate any character. In this example, the three-byte field is the major key, sorted in ascend- 
ing order: the one-byte key is a minor key sorted in descending order within the order of the major 
key. 


For a keyfile creation, only one key may be used. This key must be a maximum of 28 bytes long, 
must be a whole number of bytes in length, and must start on a byte boundary. 


For all sorts except keyfile and tagfile creation, there can be up to 10 keys. The sum of the length 
of all keys (including signs) must be a maximum of 29 bytes. 


The available key types are discussed here, under the keyword specified in the KEY statement (see ear- 
lier): 


ALPHA (or UA) 


Unsigned 8-bit alphanumeric field, containing ordinary ASCII characters. Note that this may consist 
of the 8-bit ASCII digits ‘‘0” to ‘‘9’’ but still be termed alphanumeric. This key type is the default. 


NUMERIC (or UN) 


Unsigned 4-bit numeric field, where each 4-bit unit is a binary coded decimal digit, 0000 to 1001 (0 
to 9). 
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INPUT FILES OUTPUT FILE 


Figure 5-4. File Merge 


SA 


Signed 8-bit alphanumeric field. Each byte is an ordinary ASCII character (including the digits 0-9), 
except that either the first or the last character indicates the sign. Whether the sign is the first or last 
character is specified by the keyword L (left) or R (right). The default is L (first character: leading 
sign). The convention for coding the sign character is given in table 5-1. These characters are termed 
‘foverpunched signs’? by analogy with historical punched card systems. 


DATA FILE DATA FILE 
INPUT OUTPUT 


Figure 5-5. Multiple Key Sort 


Table 5-1. Sign Convention for Signed 8-Bit Alphanumeric Fields 


j=) 


WWOAKNRWNHEDOVOAZZOA 


Note: Any other hex code in the sign character is 
interpreted as positive, with the key value given by the 
binary value of the right-hand 4 bits of the character. 
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SN 


Signed 4-bit numeric field. Each 4-bit unit is a binary-coded decimal digit, 0000 to 1001 (0 to 9), except 
that either the first or the last 4-bit unit indicates the sign. Whether the sign is the first or last 4-bit 
unit is specified by the keyword L (left) or R (right). The default is L (first 4-bit unit); leading sign. 
The convention for coding the sign is given in table 5-2. 


Table 5-2. Sign Convention for Signed 4-Bit Numeric Fields 


Key Value Binary Code (BCD 
Character) 
negative 0101 (5) 
positive 0011 (3) 


Note: Any value other than 0101 (5) is interpreted as 
positive. 


SSA 


8-bit alphanumeric field with separate sign. Each byte is an ordinary ASCII character (including the 
digits 0 to 9), with the sign given by ai ASCII characier in either the first or last character. Whether 
the sign is given by the first or last character is specified by the keyword L (ieft) or R (right). The 
default is L (first character); leading sign. The convention for coding the sign character is given in 
table 5-3. 


Table 5-3. Sign Convention for Separate Sign Character with 8-bit Alphanumeric Fields 


Key Value ASCII Character (hex 
value) 


negative “_—” (2D) 
positive “47? (2B) 


Note: Any character other than ‘‘—’’ is interpreted as 
positive. 


The position of a sign within a signed key (left or right) must be the same throughout all occurrences 
of the key. Signed keys are ordered so that negative values come before zero and positive values. 


8-bit keys may start on 4-bit unit boundaries, unless the separate sign type (SSA) is used, or the key 
is to be used in keyfile or tagfile creation. 


Deleted Records 


A deleted record is denoted by every byte in the record (including the key) containing the value hex 
FF. The action taken by the various sort options is discussed earlier. Deleted records may be physically 
removed by the FS utility. 


Output Messages 

Output messages cover warnings and errors. Messages are generated by both the sort intrinsic and the 
sort language processor. The intrinsic messages are numbered by event numbers in the same way as 
MCP output messages. The sort language processor messages are numbered in a similar way. 


Messages can be divided by number as follows: 
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0-99 


Sort language processor messages, displayed on the printer. Such messages appearing in the list below 
that are followed by a series of dots (...) should be read with the phrase NEAR COL XXX (with XXX 
replaced by an appropriate column number) in place of the dots. 


0-34 
Warnings, where corrective action is attempted. 
35-39 
Warnings, where no corrective action is attempted. 
40-59 
Errors in syntax (that is, the format of the sort statements is incorrect). 
60-99 


Errors in semantics (that is, an inconsistency has been detected in the statements, such as a key 
position greater than the record size). 


170-200 
Sort intrinsic messages, displayed on the SPO. 


Certain messages may be suppressed by the NOPRINT and NODISPLAY keywords in the sort state- 
ments. 


The NOPRINT option suppresses listing of the sort statements on the printer by the sort language pro- 
cessor. If this option is set, a maximum of five errors and four warning messages are directed to the 
SPO. The NOPRINT option has no effect on sort-intrinsic-generated messages. 


The NODISPLAY option suppresses display on the SPO of start-up and termination messages by the 
sort intrinsic. Messages in the following list that are marked with an asterisk (*) are those that are 
suppressed when this option is set. Note that it is not possible to suppress individual messages; every 
applicable message is suppressed if the option is set. The NODISPLAY option has no effect on sort 
language processor messages. 


Number Message 


EXPECTED SLASH NOT FOUND, ‘‘”? INSERTED... 

EXTRA “FILE IN’’... 

MERGE INTRINSIC IGNORES <WORK-DISK OPTION> 
OVERLENGTH PART OF <LABEL NAME> IGNORED... 

INPLACE INTRINSIC IGNORES <WORK-DISK OPTION> 
EXPECTED BRACKET NOT FOUND, ‘‘<” INSERTED... 
<DUPLICATE OPTION> VALID IN INDEX-KEYFILE SORT ONLY 
EXPECTED BRACKET NOT FOUND, ‘‘>”’ INSERTED... 

ILLEGAL TO DELETE INPUT FILE, <PURGE OPT> IGNORED 
OUTPUT BUFFER SIZE TOO BIG, <BLOCK FACTOR> REDUCED... 
<USER OPTION> ALREADY INVOKED, LATEST USE... 

MERGE <SORT TYPE OPTION> NOT SPECIFIED 


oO 


Ms Owoaoaytnunbfwn- 


ay 
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Message 
OVERLENGTH PART OF <DISK NAME> IGNORED... 
MISSING ‘FILE IN’’... 
INDEX <SORT TYPE OPTION> NOT SPECIFIED 
EXTRA ‘“KEY’’... 
<FILE SIZE OPT> VALID FOR MERGE/REGULAR SORT ONLY 
MISSING ‘“‘KEY’’... 
INPLACE INTRINSIC IGNORES <MEMORY OPTION> 
<M-FILE/DP ID> IGNORED ON NON-MAGNETIC MEDIA FILE... 
NUMBER TOO BIG, MAXIMUM VALUE ALLOWABLE ASSUMED... 
not used 
<SIGN POSITION> GIVEN FOR UNSIGNED KEY... 
FIRST UNIT NUMBERED 0 RATHER THAN 1... 
<FILE SIZE OPT> IGNORED SINCE OUT OF RANGE... 
MERGE INTRINSIC IGNORES <MEMORY OPTION> 
<BLOCK FACTOR> OF 0 NOT ALLOWED, 1 ASSUMED... 
IN-— AND OUT-FILE RECORD SIZES MADE EQUAL 
<BLOCK FACTOR> TOO LARGE, MAXIMUM ASSUMED... 
INPLACE SORT MUST HAVE IDENTICAL IN— AND OUT-FILES 
IDENTICAL IN/OUT — FILES WILL PRODUCE DUPLICATE FILE 
NOT NECESSARY TO PURGE CARD FILE... 
ALPHANUMERIC KEY DOES NOT START ON BYTE BOUNDARY... 
<KEY STATEMENT> ALREADY PROCESSED, NOW... 
<DIGIT STRING> EXPECTED... 
<CHARACTER STRING> EXPECTED... 
<SEPARATOR STRING> EXPECTED... 
<RCRD-BLCK PAIR> MUST BE GIVEN FOR NON-DISK IN-FILE... 
NO <FILE STATEMENT> SPECIFIED 
ILLEGAL WORD... 
<LETTER STRING> EXPECTED... 
MISSING <LABEL NAME>... 
UNSUPPORTED <IN/OUT MEDIA>... 
UNSUPPORTED <SORT TYPE OPTION>... 
PART OF <FILE STATEMENT> MISSING, NOW... 
NO <KEY STATEMENT> SPECIFIED 
<FILE STATEMENT> ALREADY PROCESSED, NOW... 
FINAL STATEMENT INCOMPLETE... 
TOO MANY KEY SPECIFICATIONS... 
TOO MANY FILE SPECIFICATIONS... 
INPUT FILES RECORD SIZES NOT IDENTICAL... 
<RECORD SIZE> OUT OF RANGE... 
EXTRA DIGITS IN OVERLENGTH STRING IGNORED... 
KEY LENGTH OUT OF RANGE... 
MIN LENGTH OF SN KEY IS TWO 4-BIT UNITS... 
BUFFER SIZE TOO LARGE... 
DUPLICATE <IN-FILE PARAMS>, LATEST INSTANCE... 
BUFFER SIZE TOO BIG FOR <IN/OUT MEDIA>... 
ONLY ONE IN-FILE LEGAL FROM MULTIPLE TAPE... 
MERGE INTRINSIC NEEDS AT LEAST 2 INPUT FILES 
INDEX PARAM MUST BE “OUT...<KEYFILE/TAGFILE >” 
KEY OVER-RUNS RECORD BOUNDARY 
ILLEGAL TO OVERWRITE INPUT FILE WITH TAG/KEY FILE 
ALPHANUMERIC KEY LENGTH NOT EVEN NUMBER OF 4-BITS... 


a 


(continued) 


Number Message 
76 <MEDIA> MUST BE DISK FOR IN-PLACE SORT 
77 IN— AND OUT-FILE RECORD SIZES MUST BE IDENTICAL 
78 INDEX-KEYFILE KEY LENGTH NOT EVEN NUMBER OF 4-BITS 
719 ONLY ONE KEY LEGAL IN INDEX-KEYFILE SORT 
80 INDEX-KEYFILE SORT KEY TOO LONG 
81 INDEX-KEYFILE SORT KEY MUST BE ‘“... A UA/UN>” 
82 ONLY INDEX SORT CAN SPECIFY ‘‘KEYFILE/TAGFILE”’ 
83 INDEX-KEYFILE SORT KEY MUST START ON BYTE BOUNDARY 
84 MIN LENGTH OF SSA KEY IS FOUR 4-BIT UNITS... 
85 SSA KEY MUST START ON BYTE BOUNDARY... 
86 CURRENT SUM OF KEY LENGTHS OUT OF RANGE... 
170* DUPLICATE RECORD <record number > 
171 ILLEGAL INDEX KEY IN RECORD <record number> 
172 RECORDS LOST / GAINED BY SORT-MERGE 
173 <number> DUPLICATE RECORDS 
174 <number> RECORDS CONTAINING INVALID INDEX KEYS 


175* <number> DELETED RECORDS 
176* <number> RECORDS MERGED 
177* <number> FILES MERGED 


178 SORT-MERGE OUTPUT FILE NOT CREATED 
179 SORT-MERGE ABNORMAL EOJ 
180 SORT-MERGE SOFTWARE ERROR 


181* <number> RECORDS REFERENCED BY KEYFILE/TAGFILE 

182 NO INITIATING MESSAGE 

183* <number> RECORDS SORTED 

184 FILE ERROR <<number> > NEAR RECORD <record number> ON < file 
name> 

185 UNORDERED MERGE INPUT FILE <file name> NEAR RECORD <record 
number > 

186 TOO MANY RECORDS FOR SORT-MERGE 

187 DUPLICATE RECORDS-KEYFILE NOT BUILT 

188 INITIATING MESSAGE INVALID 

189* SORT-MERGE VER x.y.z INITIATED FROM <mix number>/<program name> 

193 INPUT RECORD SIZES UNEQUAL - BAD FILE <filename> 

194 IN/OUT RECORD SIZES BAD — OUTPUT SIZE CHANGED 

195 BAD RECORD/BLOCK SIZE FOR OUTPUT DEVICE 

196 KEY OVER-RUNS RECORD END 

197 CANNOT SPLIT INDEX FILE 

198 <number> PARITY BLOCKS 

199 INDEX INPUT FILE NOT TYPE DATA 


Message 184 represents differing file errors depending on the value of <number>. Defined meanings 
are as follows: 


1 — EOF on output file 6 — input file error 

2 — parity on input file 7 — output file error 

3 — EOF on sort workfile 8 — parity on sort workfile 

4 — parity on output file 9 — parity on input file (block ignored) 
§ — sort workfile error 
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SECTION 7 
CMS SYSTEM SOFTWARE OUTPUT MESSAGES 


INTRODUCTION 


This section describes all the messages generated by the MCP, COBOL interpreter, MPL interpreter, 
NDL interpreter and SORTINTRINS. The messages are grouped by error type, for example all the 
datacomm error messages are grouped together. In each group the messages are presented in the same 
order as they appear in the SYSLANGUAGE file. 


This section is divided into two subsections: 


A — OUTPUT MESSAGES FOR B 90/B 900/CP 9500 SYSTEMS 
B — OUTPUT MESSAGES FOR B 1800/B 1900 SYSTEMS 


NOTE 
Not all messages will be displayed with the corresponding event number. 


SYNTAX RULES USED IN THIS SECTION 


A syntax diagram is constructed of words formed of upper-and lower-case letters, arrows, special char- 
acters and digits. The basic rule is that any path traced along the forward directions of the arrows 
will produce a syntactically valid statement. All words formed of upper-case letters (except ASCI}) and 
all special characters (for example commas, colons, hyphens, slashes) in the diagram will appear in the 
message as shown (acute parentheses are special characters when they are underlined). All words 
formed of lower-case letters are syntactic variables representing system supplied information. Any 
‘“‘bridge’’ over a number, such as 


es 


may be traversed the maximum number of times specified by the digit (thirteen times in this example). 


Definition of Syntactic Variables Used 


mix mix number. 

packid Disk name or pack identifier. From 1 to 7 characters. 

mfid Multiple file identification. This may be diskid or the name of a tape or 
cassette. From 1 to 7 characters. 

fileid File identification. The name of the file. From 1 to 12 characters. If the file 
is a card or printer file, the name is truncated to 7 characters. 

progname Program name. From 1 to 12 characters. 

peripheral A three character mnemonic of which the first two characters describe the 


hardware device type and the final character describes the unit within that 
type. Units are specified by characters: A, B, C ..., 
for example DKC — disk cartridge, unit C. 

device specifier Either a three character mnemonic specifying a particular device type and unit, 
as for peripheral, or a two character device type specifying the device family. 
For example DK — all disk cartridges. 

faulty input The whole of the input message up to and including the first element detected 
to be erroneous. This forms part of many output messages. 
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device status The current status of the device. This will take the form of the response to 
an OL intrinsic described in section 3. 

serial no The six digit serial number of a disk, or the five character serial number of a 
tape. 

reel The tape reel number in a multi reel tape. 

number An integer number. 

hex-number A hexadecimal number. 

priority The priority of a program (A, B or C). 

event no The event number of the message. 

filename The mfid/fileid specified in the program’s FPB. 


For indexed files, the fileid referred to is the keyfile of the key/data pair, 
unless otherwise stated. 
NOTE 
For certain files the presence of the filename is only required at close time. 
In this case, the filename displayed may not correspond to the filename which 
might be expected. 


~ 
to 
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SUBSECTION A 
OUTPUT MESSAGES FOR B 90/B 900/CP 9500 SYSTEMS 


Events 1-5 


Software Information 


These messages are information indicating error conditions. If any operator action is required, other 
message(s) will immediately follow. 


Message Syntax: 


mix/progname HARDWARE ERROR ————— < event no > message ——————> 
>——_ DURING DATA function peripheral FILE —— filename ————> 
>—_ WHEN ATTEMPTING ————— _ verb ————_ ONFILE status ————_—_| 
Where: 
message Sven Anse cape Uelow 
function “INPUT FROM” or ‘SOUTPUT TO” 
verb specifies the communicate that was being performed when the error occurred — for 
example READ, WRITE. 
status ““DISK ADDRESS address”’ or ‘‘null’’ 
NOTE 


If there is an input/output error on a disk device during a hardware search, 
the disk address given is not valid, it shows where the search started from. 
The error is somewhere beyond this point. 


Event Message Possible Causes Suggested Action 
I DATA Ending label is missing or None. Program has indicated it can 
FORMAT invalid. handle the error. 
CORRUPTION 
2 PARITY Hard parity error found on this None. Program has indicated it can 
device. handle the error. 
3 DEVICE For tape device, no data was None. Program has indicated it can 


MALFUNCTION found for quite a distance on handle the error. 
the tape (exact length depends 
on unit). For disk, cylinder 
specified could not be used. 


4 DATA NOT Sector could not be found on None. Program has indicated it can 
LOCATED disk (cylinder was found). handle the error. 
Software has indicated an invalid 
sector or sector address on disk 
is corrupt. 


2032801 


SSE 


(continued) 


Event Message Possible Causes Suggested Action 
5 The device is not write enabled. Write enable the device and retry 
MEDIA program. 
WRITE 
PROTECTED 


7-4 


I I 


Events 6, 22-27, 29-37. 40-41, 69, 79-81, 84, 87, 89-90 
Invalid Requests on Class A or B Communicate to MCP (1) 


Message Syntax: 


PROGRAM ERROR 


———_ mix/progname 


<event no > —————_ message ————> 
filename —_——_j 


ON FILE 


verb 


>—_ WHEN ATTEMPTING 


These messages normally indicate program errors. The program in error should be DS’ed or DP’ed 
(see DS or DP intrinsics), if necessary. The operator should then attempt to run the program again. 
If the same error is encountered, request technical assistance. 


Event Message Possible Causes Suggested Action 
6 DUAL PACK Use of a disk pack file is no 
FILES NO longer supported. 
LONGER 
SUPPORTED 


iw 
to 


UNEXPECTED The medium which contained the Replace the medium into the same 


REMOVAL OF file has been iliegaliy, physicaily drive it was removed from and 


DEVICE removed when it was still ready the drive using the RY 
required. intrinsic. 

23 FILE WAS The attributes specified by the 

OPENED program are conflicting. For 

WITH example a write to an input only 

ATTRIBUTES file. 

THAT ARE 

INCOMPATIBLE _ 
24 INVALID The program has attempted to 

SEQUENCE perform an invalid sequence of 

OF FILE communicates, such as: 


OPERATIONS | 1. A rewrite not immediately 
preceded by a successful read. 
2. An overwrite immediately 
preceded by an open or start 
communicate. 
3. An overwrite or rewrite 
preceded by a conditional read 
which failed. 


25 SPECIFIED The work area segment specified 
RECORD within the FIB cannot be used, 
WORK AREA either because it indicates an 
UNUSABLE FIB segment or it is a read only 

segment; but the communicate 
requests a data transfer to that 
segment. 
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(continued) 
Event Message Possible Causes Suggested Action 
26 ILLEGAL The key provided on a write 
INDEX KEY communicate to an indexed file 
(VALUE was equal to binary zero or a 
ZERO OR byte of @FF@. 
CONTAINING 
@FF@) USED 
27 REQUEST There is no device of the Do not use the program requesting 
FOR NON- required kind present on the this device. 
EXISTENT system. 
DEVICE 
29 DUAL PACK The two parts of a dual pack Check both disks contain the 
FILE file have been found to be correct version of the file, replacing 
INCONSISTENCY inconsistent. the file if necessary. 
30 =FILE The communicate requested an 
ALREADY open of a already open file. 
OPEN 
31 FILE The communicate requested a 
ALREADY close of an already closed file. 
CLOSED 
32 FPB OPEN The adverb to open was 
OPTIONS determined to be illegal for any 


INCOMPATIBLE of the following reasons: 

OR INVALID 1. Myuse equal to zero. 
2. Myuse incompatible with 
device, for example input/output 
for line printer. 
3. Access mode random for non- 
disk device. 
4. Access mode not equal to 
sequential, random or stream. 
5. Shared access mode not 
random or sequential. 


33 INVALID The record and/or block size 
RECORD OR has been determined to be 
BLOCK SIZE incompatible or illegal for any 
SPECIFIED of the following reasons: 

1. Buffer or record length equal 
to zero for new disk or tape 
files. 

2. Record length exceeds physical 
block size. 

3. Buffer length not an integer 
multiple of record length. 


34 MAXIMUM The maximum file size exceeds 
FILESIZE 1048576 — 16 * number of 
EXCEEDED sectors in an allocation unit, or 


65536 -— number of sectors in 


Event 


35 


36 


37 


40 


41 


69 


79 


80 


81 
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Message 


MORE THAN 
16 BUFFERS 
REQUESTED 


INVALID 
DEVICE 
REQUESTED 


WRONG FILE 
TYPE 
SPECIFIED 


Invalid INDEX 
KEY SIZE 
SPECIFIED 


INDEX 
KEYFILE 


INCONSISTENCY 


A DISK FILE 
HEADER 
MISMATCH 
DUE TO 
CORRUPTION 
WAS 
DETECTED 


INDEX 
KEYFILE 
CORRUPTION 


INDEX 
KEYFILE NOT 
WHOLLY IN 
DATA 
RECORD 


PART OF 
FILE 
MISSING 


(continued) 
Possibie Causes 


one allocation unit if a single 
area file. 


The number of buffers specified 
exceeds 16. 


The device requested is not 
supported by the CMS operating 
systems. 


A mismatch between the file 
type fields of the FPB and the 
DFH has been found during an 
open, or user attempted to 
access a protected file. 


An attempt has been made to 
open an indexed file with key 
size greater than 28, or with a 
key size equal to zero and access 
not sequential input, or input/ 
output. 

The implementation number in a 
key file KFPB is greater than 
this implementation (this is 
currently 1). 


There is an area-assignment 
mismatch on an extendable 
pseudo pack. 


The MCP has detected an 
inconsistency in the format of a 
key file during an indexed open. 


The MCP has detected that the 
key for an indexed file is not 
wholly contained within the data 
record. 


The file containing the second 
half of a dual pack file or the 
file containing the data file of 
an indexed pair cannot be 
located. The operating system 
will cancel the suspension when 
the file is made available. 


Suggested Action 


Make the required file available to 
the system. 


Ss 


(continued) 
Event Message Possible Causes Suggested Action 
84 INVALID USE A valid communicate was issued 
OF to the wrong device type. For 


COMMUNICATE example, test status ,which is 
valid for any disk file or ICMD 
file, and unconditional variant 
valid for tape file, so if either 
of these is issued to a card 
reader, this error would 
produced. Error may also be 
issued for other reasons. 


87 ACCESS A sequential read has been 
BEYOND END attempted after notification of 
OF FILE end of file. 

89 FPB AND The tape currently in use has 
TAPE NAME the wrong name, perhaps due to 
MISMATCH wrong reel being mounted. 

56 TAPE LABEL Tape is not of the requested 
AND FPB format. 

ATTRIBUTE 
MISMATCH 
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Events 10-19, 28, 39, 42, 82, 85, 88 
Software Suspensions 


When a running program encounters a condition that prevents it from continuing, the MCP suspends 
the program and informs the operator as to the reason for the suspension. When the condition is 
cleared, the MCP normally allows the program to continue running. If the program does not continue 
automatically, the operator should issue a ‘“‘GO”’ command (see ‘‘GO”’ intrinsic in section 3) to the 
program. 


All these messages requests the use of the ‘‘HELP”’ command (see ‘‘HELP”’ intrinsic in section 3) for 
further details. 


Message Syntax: 


mix/progname PROGRAM SUSPENSION <event no > ————————_——> 


FILE ——— filename ———— message — 


>——_ ASSISTANCE REQUIRED FOR peripheral 


Event Message Possible Causes Suggested Action 

10 FILE DOES Disk or tape file this program Check for correct disk or tape; 
NOT EXIST necds has not been found. supply program with backup copy 
ON peripheral of file requested. 

11 THIS FILE While attempting to place a Normally, use RM to remove the 
ALREADY certain file on disk or tape, existing file from disk. If in doubt 
EXISTS ON program has discovered a file refer to program instructions. For 
peripheral with the same name already non-disk devices, either power off, 

exists on the device. The or save the unwanted device. 

program halts as more than one 

file with the same name cannot 

reside on the same device. 

12 number DISK The space available on disk is Remove with RM any unnecessary 
SECTORS insufficient to hold the file this files and as soon as there are 
NEEDED FOR program is attempting to write. sufficient sectors available on the 
FILE disk the program will continue. 

Or disk is checkerboarded. Or, if the disk is checkerboarded, 
terminate the suspended program 
using the DS intrinsic, then use the 
SQ utility to consolidate disk space. 
Then re-execute the program. 

13 NO FREE When the disk was initialized, Remove with RM any unnecessary 
DISK the disk directory was files and program will continue. Or, 
DIRECTORY constructed to contain a fixed DS the suspended program, replace 
AVAILABLE number of file names. The disk with another disk having 

directory has now reached its sufficient directory space, and re- 

capacity. execute the program. 

14 peripheral NOT Device that program needs in RY required device, or assign to 
CURRENTLY _ order to continue processing is alternative device using the AD 
AVAILABLE either saved, not ready or in use _ intrinsic. 

by another program. 
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Event 
15 


16 


17 


18 


19 


28 


39 
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Message 


SPECIAL 
peripheral 
FORMS 
REQUESTED 


INDEX 
KEYFILE- 
DATAFILE 
GENERATION 
NUMBER 
DISCREPANCY 
— RECREATE 
KEYFILE 


peripheral NOT 
ONLINE 


MULTIPLE 
DEVICES OF 
THE NAME 
SPECIFIED 
ARE ONLINE 


ACCESS 
DENIED 
UNTIL 
OTHER 
PROGRAMS 
CEASE USING 
FILE — 
PLEASE 

WAIT 


USE ‘“AD”’ 
COMMAND 
TO ASSIGN 
DEVICE 


INVALID 
FILENAME — 
USE “SF” 
COMMAND 
TO CORRECT 
NAME 


(continued) 
Possible Causes 


Program is waiting for operator 
to insert correct forms into the 
output device before it will 
continue processing. 


While opening an old indexed 
file, a discrepancy has been 
found between the generation 
fields of the keyfile and the data 
file. The operating system will 
cancel the suspension when the 
discrepancy no longer exists. 


Program needs a disk or tape 
that is not available to the 
system. 


Two or more disks or tapes 

having the same names have 

been found on-line. Only one 
disk or tape of a given name 
may be on-line at a time. 


The specified file cannot be 
opened because it has already 
been opened by the maximum 
number of users allowed for the 
desired mode of use. 


An open of an unlabelled file 
requires a device to be assigned. 


OPEN or CLOSE has detected 
an illegal special character 
embedded in the filename. 


Suggested Action 


Insert correct forms into output 
device. Then use AD intrinsic to 
assign device to program. 


DS the program and either run the 
“KEY.CHECK”’ utility, or SORT 
the data file to produce a new 
keyfile. Then re-execute. 


Mount the correct media and ready 
the device using the RY intrinsic. 
Or allow program currently using 
the device to go to end of job and 
then the suspended program will 
automatically be able to use the 
device. 


Check for correct disk or tape, 
replace or relabel one of the 
duplicates. 


Wait until the file is not in use. 


Assign the required device using the 
AD intrinsic. 


Use the SF intrinsic if implemented. 


Event 
42 


82 


85 


88 
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Message 


ANOTHER 
PROGRAM 
EXCLUSIVELY 
USING DISK 

— PLEASE 
WAIT 


DISK 
CONTAINING 
PART OF 
FILE 
MISSING 


FILE NOT 
FOUND ON 
TAPE — TRY 
ANOTHER 
TAPE 


TAPE IS 


a 


(continued) 
Possible Causes 


The disk requested by the 
program is in use by another 

program which has ‘‘locked’’ 
access of the disk. 


The disk containing the second 
half of a dual pack file or 
containing the data file of an 
indexed pair cannot be located. 
The operating system will cancel 
the suspension when the file is 
made available. 


The tape does not have the 
required file. 


The tape is write disabled. 


Suggested Action 


Wait for the disk to become 
available. 


Ready the required disk using the 
RY intrinsic or load the required 
disk onto the system. 


Replace the tape with one which 
has the required file. Then assign 
the drive to the program using the 
AD intrinsic. 


Replace the tape with a write 
enabled tape. Then assign the drive 
meagram ucina the AD 


4m tha 4 
LU LIL plUBialii Yoiig tiin 4 


intrinsic. 


Events 20-21 
Invalid Requests on Class A or B Communicate to MCP (2) 


Message Syntax: 


mix/progname 


PROGRAM ERROR ————— < event no> 


message ————————> 


>——_ WHEN ATTEMPTING TO USE siete sol (aaa 
verb 
i INVALID VERB inv_verb (in hex ) ji 
DATA SEGMENT non_FiB segment-no 
These messages normally indicate program errors. The program in error should be DS’ed or DP’ed 


(see DS or DP intrinsics), if necessary. The operator should then attempt to run the program again. 
If the same error is encountered, request technical assistance. 


Event Message Possible Causes Suggested Action 


20 no message An illegal verb has been used in 
a communicate. The ‘‘inv. verb’’ 
field contains the hexadecimal 
value of the illegal verb. 


21 WRONG The data segment table did not 
DATA contain an index to a valid FIB. 
SEGMENT The ‘‘non-FIB segment-no’’ field 
SUPPLIED contains the segment number in 

decimal. 


dl 
he 
i) 


Events 43-48 
Device Errors 


These error messages indicate terminations due to fatal device errors. These errors are normally encoun- 
tered when attempting to read disks or magnetic tapes. The program which encountered these errors 
should be DS’ed or DP’ed (see DS and DP intrinsics). The operator should then attempt to run the 
program again. If the same error is encountered, the disk or tape involved should not be used again 
until field engineering has been notified and the media have been checked. 


Message Syntax: 


mix/progname —————— HARDWARE ERROR ————_ < event no > message ———__> 
>—_ DURING ————__ function RESERVED AREAS OF peripheral FILE ———> 
>— filename ———————. WHEN ATTEMPTING —————— verb ———— ON FILE status —_ 
Where: 
function “INPUT FROM” or “OUTPUT TO” 
verb specifies the communicate that was being performed when the error occurred — for 
example READ, WRITE. 
staius “DISK ADDRESS address”’ or ‘null’. 
Event Message Possible Causes Suggested Action 
43 END OF An unexpected end of the tape 
MEDIA has been encountered. 
44 DATA The end label is missing or a 
FORMAT labelled tape is invalid. 
CORRUPTION 
45 PARITY A hard parity error was 


discovered by the device during 
label processing. 


46 DEVICE When reading a tape device no 
MALFUNCTION data was found for quite a 
considerable distance along the 
tape, the exact length is device 
dependent. For disk, the sector 
specified could not be found. 


47 DATA NOT The specified cylinder was found 
LOCATED but the required sector was not 
found. Either the software has 
indicated an invalid sector or the 
disk/sector address is corrupt. 


48 MEDIA The peripheral is found to be 
WRITE write inhibited. 
PROTECTED 
2032801 


ree 


Events 49-68, 76-78 


Loader Detected Failures 


These messages indicate that the MCP failed to begin the processing of a particular program for some 
reason. The operator should correct the condition which caused the load failure and then try running 
the program again. 


Message Syntax: 


Event 


49 


50 


51 


52 


53 


54 


55 
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Message 


PROGRAM 
TYPE NOT 
SUPPORTED 


DISK 
MISSING 


PROGRAM 
FILE 
MISSING 


NO FREE 
MIX SLOT 


faulty input 


Possible Causes 


This type of program is not 
supported by the system. 


The specified disk is either not 
ready, or not on-line. 


The specified program file was 
not found on disk. 


The program specified cannot be 
run at the present time for one 

of the following reasons: 

1. No mix slots are available for 
a program in this priority class. 

2. Another program present will 
not allow any other programs to 
enter the mix. 


INSUFFICIENT There is not enough disk space 


FREE DISK 
SPACE 
AVAILABLE 


for the program’s Virtual 
Memory file (VMFILE) or the 
file directory of the disk has no 
entries for the creation of new 
files. 


INTERPRETER The required interpreter is not 


FILE 
MISSING 


OTHER 
USERS 
DENYING 
ACCESS TO 


on the system disk with its 
executing name. 


A request to exceed the 
maximum number of concurrent 
users of a file has been 
attempted. The maximum 


PROGRAM LOAD FAILURE —— <event no > me filename —— WILL NOT RUN 


INVALID LL message — 


Suggested Action 


Check that the correct disk has 
been loaded. Ready the disk with 
the RY intrinsic if it is not ready. 


Check that the correct program and 
disk name were entered and re- 
input if necessary. Ensure the disk 
contains the program required. 


Wait for a suitable time to execute 
the program, or perform an orderly 
termination of some of the current 
programs. 


Make disk space available for 
program by either removing 
unwanted files from the disk, or 
copying files not required at the 
moment to backup, then remove 
them from the disk. 


Ensure that the necessary interpreter 
(for example, BILINTERP, 
COBOLINT, SORTINTRINS) is on 
the system disk with its executing 
name. 


Wait until one or more of the 
programs currently using the file 
terminates. 


Se 8S SS SS SS Se 


Event 


56 


57 


58 


59 


60 


61 


62 


63 


64 
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Message 
PROGRAM 


PROGRAM 
FILE 
CORRUPT 


UNABLE TO 
DETERMINE 
PROGRAM 
NAME DUE 
TO ERROR 
IN LOAD 
REQUEST 


(continued) 
Possible Causes 
number of concurrent users will 
not exceed seven. 


The file type for the file 
specified was not a code file 
type. For example, the file was 
data or key file type. 


The program name specified in 
EX command was invalid. For 
example it contained too many 
characters. 


INSUFFICIENT There is not enough memory 


MEMORY 
AVAILABLE 


MAXIMUM 
ALLOWED 
MCS 
PROGRAMS 
ALREADY 
RUNNING 
DUPLICATE 
DISKS 
ONLINE 


OTHER 
PROGRAMS 
RUNNING 


NDL 
PROGRAMS 
CANNOT BE 
LOADED 
DIRECTLY 


DISK 
HARDWARE 
ERROR 


ENCOUNTERED 


space to hold this program’s 
Task Contro! Block (TCB) and 
its Program Control Block 
(PCB). 


The maximum number of MCS 
programs is already reached. 


Two or more disks with the 
same name are online. The 
system requires all disks on the 
system to have a unique name. 


The specified program may only 
run in a mix in which only the 
datacomm, SYS-SUPERUTL and 
SPIM (if running) are present. 
ALSO SYS-SUPERUTL must be 
in a non-executable state. 
executable state. 


An NDL task can only be 
loaded as part of the data 
comm loading sequence. Any 
other attempt to load an NDL 
task will fail. 


There has been an irrecoverable 
disk error while attempting to 
load a program. 


SUPERUTILITY An attempt has been made to 


FUNCTION 
ALREADY 


use one of the functions of 
SYS-SUPERUTL while this 


Suggested Action 


Check input and re-enter. 


Check input and re-enter. 


Wait for other programs to 
terminate. If this condition persists, 
request technical assistance. 


None. 


Remove unnecessary pack or 
rename one of the disks using the 
RL intrinsic. 


Wait for the mix to become 
suitable for executing this program. 


Use the required NDL loading 
sequence. 


Use backup copy of the required 
program. If the problem continues, 
request technical assistance. 


Wait until the current SYS- 
SUPERUTL function has completed 
before entering the required function. 
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SSS 


Event 


65 


66 


67 


68 


76 


77 


78 
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(continued) 
Message Possible Causes 
RUNNING utility is performing another 
function. SYS-SUPERUTL 
functions are IR, LB, LF, CH, 
KX, PD and RM. 


INSUFFICIENT The program structure cannot be 
MEMORY constructed within the amount of 


REQUESTED memory specified in the real 
store field in the the EX 


intrinsic. 
DUAL The program requires the 
ALPHABET/ interpreter and MCP to support 
REVERSE dual alphabet or reverse 
ESCAPEMENT escapement and the current 
PRINTER system does not. 
FEATURES 
NOT 
SUPPORTED 
ON THIS 
SYSTEM 
ERROR IN The file equate in the EX 


FILE NAME command referenced an internal 
EQUATION file which did not exist. 


ANOTHER Another program has locked the 
PROGRAM required disk. 

HAS 

EXCLUSIVE 

CONTROL OF 

SPECIFIED 

DISK 

INTERPRETER The interpreter and the MCP 
VERSION levels are incompatible. 

AND 

CURRENT 

MCP 

INCOMPATIBLE 

IT IS NOT A __ The file type for the file 
PROGRAM specified was not a program file 
FILE type. 

SPECIFIED The MCS specified has already 
MCS started. Enter ‘“‘MX’’ for details. 
ALREADY 

RUNNING 


Suggested Action 


Do not use this program with this 
implementation of CMS. 


Check input and re-enter the 
execute command (EX intrinsic). 


Wait until the program holding the 
lock on the required disk 
terminates, then re-execute the 
program. 


Copy the required interpreter from 
backup media, then re-execute the 
program. 


Check input and re-enter. 


Events 70-75 


Run Structure Problems 


These messages are output to indicate failure on execution of a program. The program encountering 
these errors should be DS’ed or DP’ed (see DS DP intrinsics) if necessary. The operator should then 
attempt to run the program again. If the same error is encountered, request technical assistance. 


Message Syntax: 


mix/progname 


Where ‘“‘text’’ is: 


PROGRAM ERROR 


< event no > 


‘PROBABLE COMPILER/INTERPRETER FAULT”’ 


“INSUFFICIENT RESOURCES REQUESTED”’ 


70, 71, 73 
72, 74 
75 “AMEND PROGRAM’”’ 
Event Message 
70 ACCESS ATTEMPTED TO 


~dJ 
a 


72 


73 


74 


75 
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NON-EXISTENT SEGMENT 


ACCESS ATTEMPTED 
BEYOND END OF 
SEGMENT 


ACCESS ATTEMPTED 
BEYOND END OF 
CONTROL STACK 


ACCESS ATTEMPTED TO 
NON-EXISTENT DATA ON 
CONTROL STACK 


INSUFFICIENT MEMORY 
REQUESTED AT PROGRAM 
LOAD 


PROGRAM REQUIRES 
MORE MEMORY THAN 
SYSTEM CAN PROVIDE 


Possible Causes 


The segment number exceeds the 
number of segments declared in 
the program. 


The length of the segment 
exceeds the declared size of the 
segment. 


The amount of control stack 
declared in the program has 
been exceeded during execution. 


The specified program has 
attempted to retrieve more 
information from the control 
stack than is present. 


The program has attempted to 
exceed the memory size specified 
at execution (load) time in the 
real store field. Refer to EX 
intrinsic. 

The program has attempted to 
exceed the physical memory size. 


message 


text ——— 


Suggested Action 
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Event 83 


Unimplemented Communicates 


This message is output to indicate that this CMS machine does not support the referenced communi- 
cate. 


Message Syntax: 
mix/progname ————— PROGRAM ERROR —————— < event no> ———~_ verb ———————- 


>—————._ VERB NOT SUPPORTED ON THIS CMS MACHINE, ————_—_——_____ 
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Event 91 


Message Dictionary Section 


This message is output to indicate that the MCP cannot generate the requested message because it has 
not found the appropriate section in the dictionary file. 


Message Syntax: 


CANNOT GENERATE 


section MESSAGES FOR mix/progname ————> 


>——_ section —— SECTION OF DICTIONARY FILE iS NOT PRESENT = INFORM SUPPORT PERSONNEL —— 
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Events 100-169 
Interpreter Detected Errors 


These messages indicate that a program interpreter has encountered an error on execution of the pro- 
gram. The program in error should be DP’ed (see DP intrinsic) if necessary. The source program, ob- 
ject program, dumpfile produced by DP and any data files used by the program should be saved. The 
operator should then try to run the program again. If the same error is encountered, request technical 
assistance and supply all relevant data saved to the technician. 


Message Formats: 


mix/progname ——-—--._. PROGRAM ERROR ———————._ < event no > ——————_> 
>—_——- message ————————— =AT CODE SEGMENT ————~——_ seg parameter ——_> 
>————._ OF FSET ———. offset —___—__-_ text ——_—__ parameter ————— 


100-105 “PROC/DEBUG LINE” for MPL and COBOL interpreter detected errors. 
110-132 “‘PROCEDURE”’ for MPL-interpreter detected errors. 
140-169 “(DEBUG LINE”’ for COBOL-interpreter detected errors. 


Events 100-105 MPL/COBOL Interpreter Detected Errors 


Event Message Possible Causes Suggested Action 


100 COMMUNICATE MCP returned @80@ in Byte 0 
ERROR of Fetch Message on a 
communicate. 


101 COMMUNICATE MCP returned an End of File 
EOF ERROR indication in Fetch message 
(@20 10 00@) and the user has 
not specified any action if EOF 


occurs. 
102 COMMUNICATE MCP returned an I/O error 
I/O ERROR other than EOF (@20 10 00@) 


in Fetch message and user has 
not specified any action to be 
taken if error occurs. 


103 SEGMENT Interpreter detected an invalid 
NUMBER data segment number. 
ERROR 

104 WRITE Interpreter detected an attempted 
ERROR WRITE to a Read-Only Segment 


or, if COBOL, a literal. 
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Event Message 

105 SEGMENT 
BOUNDARY 
VIOLATION 


NL 14% 7 
BVCUILS LUO-LVUyZ Teservea 


2032801 


(continued) 
Possible Causes 


Interpreter, on trying to resolve 
an address, has discovered that 
the address of the data or code 
is out of range. 


ae hee 


r future use. 


Suggested Action 
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Events 110-132 MPL Interpreter Detected Errors 


Event 
110 


Message 
INVALID OP 


Events 111-114 reserved for future use. 


115 


116 


117 


118 


119 


120 


121 
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DESCRIPTOR ACCESS 


SEGMENT SIZE ERROR 


ADDRESS ERROR 


MESSAGE REFERENCE 
ERROR 


STRING STORAGE ERROR 


REMAP ERROR 


SUBSTRING ERROR 


Possible Causes 


Code file has become corrupt 
or, an error exists in MPLII 
compiler or interpreter, or an 
old level of interpreter with 
same feature not implemented. 


Program tried to store the fetch 
value to a non-character field; 
to convert to a non-character 
field; or to store to a self- 
relative descriptor. Or, an error 
occurred in the SETNAME 
procedure, or in the parameter 
in decimal arithmetic. Other 
possible errors are: key not 
character (8) in authenticate, 
message not character in 
authenticate, or monitor 
parameter out of range. 


The length assigned at run time 
to a segment or segmap page 
must be less than equal to the 
maximum length specified, and 
the segment must not have been 
used by the program before the 
SEGMENT/SEGMAP statement 
has been encountered at run- 
time. 


SETNAME extent error; 
identifier has become out of 
scope. 


Size of message reference field 
not divisible by 4, or illegal 
access to message reference 
field. 


Illegal destination in store string 
instruction. 


Program tried to re-map a bit 
descriptor. 


Attempt made to sub-string into 
a non-character area, or length 
of substring greater than 255, or 
substring not wholly contained 
in area being substringed. 


Suggested Action 


Event 
122 


123 


124 


128 


129 


130 


131 


132 


Message 


INDEX ERROR 


EXIT ERROR 


CPA ERROR 


DIVIDE ERROR 
ZIP ERROR 


BIT DESCRIPTION ERROR 


FPB ERROR 


CONTROL STACK ERROR 


DATA STACK ERROR 


DECLARATION MODE 
ERROR 


DATA STRUCTURE ERROR 


Events 133-139 reserved for future use. 
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(continued) 
Possible Causes 


Program tried to index a self- 
relative descriptor, or to bit 
index a self-relative descriptor. 


Local data returned from a 
function. 


Error in communicate parameter 
area: for example, message 
reference expected, or character 
field of 3 bytes expected. 


Divide by zero attempted. 


Error returned after ZIP (not 
used on B 80). 


Bit field overlaps more than one 
byte boundary. 


Error in file parameter block 
encountered, or subfield of a 
non-FPB segment requested. 


Control Stack overflow in 


rPammunicate i i 
communicate iunstruchion,: Or 


control stack underflow in exit 
instruction. 


Illegal descriptor encountered. 
Usually caused by overwriting 
descriptors on the data stack by 
data in an assignment statement, 
where the left hand side has a 
bad offset value. For example 
A(X):= VAL; where X is too 
big — this will write beyond the 
end of A and may corrupt 
descriptors. 


Size of character field greater 
than 255. 


Insufficient room for structure 
nesting or size of character field 
greater than 255, or insufficient 
room for array bound 
evaluation, or non-character 
descriptor encountered when 
character descriptor expected. 


Suggested Action 
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Events 


Event 
140 


141 


142 


143 


144 


145 


146 


147 


148 


149 


150 


151 


152 
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140-169 COBOL Interpreter Detected Errors 


Message 
INVALID S-OP CODE 


INVALID COPX — 
GREATER THAN SIZE OF 
COP TABLE 


ALPHANUMERIC FIELD 
TYPE NOT 8-BIT 
UNSIGNED 


INVALID EDIT MICRO 
OPERATOR 


INLINE EDIT MASK NOT 
CORRECTLY TERMINATED 


EXAMINE SOURCE FIELD 
ERROR 


EXAMINE PARAMETER 
FIELD NOT 8-BIT 
UNSIGNED, ONE 
CHARACTER 


EXAMINE CONTROL BYTE 
ERROR 


COMPARE FOR CLASS - 
CLASS AND FIELD TYPE 
INCOMPATIBLE 


SUBSCRIPTED OR 
INDEXED SUBSCRIPTED 
OR INDEX 


INDEXED/SUBSCRIPT 
VARIABLE IS INDEXED/ 
SUBSCRIPTED BY MORE 
THAN 3 VARIABLES 


FETCH COMMUNICATE 
RESPONSE FIELD NOT OF 
LENGTH 3 BYTES 


INVALID EXAMINE 
SPECIFICATION 


Possible Causes 


Invalid S-Op-Code. Code file is 
corrupt or error exists in 
COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG RPG compiler 
or interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG RPG compiler 
or interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. exists in COBOL/ 
RPG RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Suggested Action 


aE 


(continued) 
Event Message Possibie Causes Suggested Action 


Events 153-157 reserved for future use. 


158 PERFORM STACK Attempt to exit from a module 
UNDERFLOW when not in a called module. 
Corrupt code file or error exists 
in COBOL/RPG compiler or 


interpreter. 

159 CANNOT OPEN NEW Program attempted to create a Perform suitable 
OUTPUT FILE WHEN file on disk with a filesize of alterations to the 
VALUE OF FILESIZE IS zero. Invalid code as no records program which 
ZERO could ever be output to the file allow the program 

created. to create a file with 
non-zero filesize. 

160 PERFORM STACK Indicates that the number of The size of the 
OVERFLOW nested PERFORM statements Perform Stack may 


exceeds that allowed within the be increased by 
Perform Stack at compile time MODIFY utility, 
(if not specified then the default using 

value is used). If this did not CONTROL.STACK 


result from programming error, option to change 
the Perform Stack should be the PPB (see section 
increased. A), 


161 NON POSITIVE SUBSCRIPT Subscripts must be a value 
greater than zero. 


162 ARRAY BOUND Subscript outside the upper 
VIOLATION bound of OCCURS clause. 
Event 163 reserved for future use. 
164 TRANSLATION SOURCE In an MPL TRANSLATE 
ERROR statement the translation text or 


translation table not of type 
character (1). 


165 NO STOP RUN End of code file has been 
ENCOUNTERED encountered but no STOP RUN 
statement has been found. 


166 INVALID SIGN CODE 


167 1/O ERROR Invalid READ/WRITE to a file 
encountered. 


168 SORT OR MERGE ERROR An error has been encountered 
in SORT or MERGE. 


169 ZIP FAILURE Zip of another task has failed. 
For example zipped program not 
present, zipped file is not a 
code-file. 


2032801 
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Saga se 
Events 170-199 _ 


Sort/Merge Information 


Message Format: 


mix/progname 


< event no > 


< message > ———_——_——_ 


The following messages may be output while SORT or SORTINTRINS is running. They will display 
the name of the program which executed or attempted to execute SORTINTRINS, the MCP event 
number and a message to explain why the event was displayed. 


Event 


170 


171 


172 


173 


174 


175 


176 


177 
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Message 


Possible Causes 


DUPLICATE RECORD record Only for keyfile creation. 


number 


ILLEGAL INDEX KEY IN 
RECORD key 


RECORDS LOST/GAINED 
BY SORT-MERGE 


number DUPLICATE 
RECORDS 


number RECORDS 
CONTAINING INVALID 
INDEX KEYS 


number DELETED RECORDS 


number RECORDS MERGED 


number FILES MERGED 


Another record in the file has 
the same key as this record. 


Only for keyfile creation. The 
key field contains either all 
binary zeros or has one or more 
bytes with @FF@. This record 
will not be referenced from 
keyfile. 


Probably indicates an error in 
SORTINTRINS. 


Normal message. Tells the 
operator the total number of 
records that have duplicates. (See 
Event 170). 


Normal message. Tells operator 
the total number of records with 
invalid index keys. (See Event 
171). 


Informs the operator that a 
number of records were deleted 
as they contained only hex FF 
in every byte. 


Normal message for MERGE 
only. Tells the operator the total 
number of records merged from 
all files. 


Normal message for MERGE 
only. Tells the total number of 
files merged. Should be the same 
as the number requested in the 
Sort Spec. 


Suggested Action 


If duplicates are 
desired, specify 
“DUPLICATES’”’ 
on input. 


None. 


See introductory 
paragraph 
concerning errors. 


None. 


None. 


None. 


None. 


None. 


Event 
178 


179 


180 


181 


182 


183 


184 


185 


186 
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Message 


SORT-MERGE OUTPUT 
FILE NOT CREATED 


SORT-MERGE ABNORMAL 


EOJ 


SORT-MERGE SOFTWARE 
ERROR <SEG number 


OFFSET number > 


number RECORDS 


REFERENCED BY KEYFILE/ 


TAGFILE 


NO INITIATING MESSAGE 


number RECORDS SORTED 


FILE ERROR <number> 
NEAR RECORD number ON 


filename 


UNORDERED MERGE 
INPUT FILE filename NEAR 


RECORD number 


TOO MANY RECORDS FOR 


SORT-MERGE 


(continued) 
Possible Catses 


SORTINTRINS was DS’ed. May 
indicate corrupt SORT or 
SORTINTRINS programs. 


Early termination due to errors. 


Error in SORTINTRINS. 


Only for keyfile/tagfile creation. 
Tells the number of records 
referenced by a keyfile/tagfile. 


SORT intrinsic requires a 
properly coded initiating 
message. This should be properly 
formatted by SORT or Sorts 
within programming languages 
such as COBOL. Probably 
indicates an attempt to execute 


SORTINTRINS directly. 


Normal message. Tells operator 
the number of records sorted by 
a successful data file SORT. 


The message informs the 
operator that an error has been 
encountered within the specified 
file near the specified record 
number. The <number> means: 
. EOF on output file. 

. Parity error on input file. 

. EOF on Sort Workfile. 

. Bad disk address. 

. SORT workfile error. 

. Input file error. 

. Output file error. 

Except for 2, this probably 
indicates an error in 
SORTINTRINS. 


Files to be merged did not have 
an increasing/decreasing key 
value. Either the file is incorrect 
or the key position has been 
incorrectly specified. 


AAU hWN 


Machine dependent limitation. 


Suggested Action 


See introductory 
paragraph 
concerning SORT 
errors. 


See introductory 
paragraph 
concerning SORT 
errors. 


None. 


None. 


None. 


See introductory 
paragraph 
concerning SORT 
errors. 


SORT files for 
correct order, then 
retry. 


See introductory 
paragraph 
concerning SORT 
errors. 
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Event 
187 


188 


189 


193 


194 


195 


196 


197 


198 


199 
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Message 


DUPLICATE RECORDS —- 
KEYFILE NOT BUILT 


INITIATING MESSAGE NOT 
VALID 


SORT-MERGE version 
INITIATED FROM mix 
number/program name 


INPUT RECORD SIZES 
UNEQUAL —- BAD FILE 


filename 


IN/OUT RECORD SIZES 
BAD — OUTPUT SIZE 
CHANGED 


BAD RECORD/BLOCK SIZE 
FOR OUTPUT DEVICE 


KEY OVER-RUNS RECORD 
END 


CANNOT SPLIT INDEX 
FILE 


number PARITY BLOCKS 


INDEX SORT INPUT FILE 
NOT TYPE DATA 


(continued) 
Possible Causes 


DUPLICATES was not specified 
on input and they were found to 
exist. This message age will be 
displayed and no keyfile will be 
built. 


Initiating message supplied to 
SORTINTRINS is not in proper 
format. This could be caused by 
a fault in the program that 
zipped the SORTINTRINS. 


Normal message to inform the 
operator which version of the 
SORTINTRINS is in use and by 
which program. 


For a merge sort, the input files 
do not have the same record 
size. The offending file is 
named. 

The output file has been 
specified with a record size 
different to that of the input 
file. This has been corrected 
automatically. 


The output file buffer size must 
be less than 32768 for disk file. 


Key limit is beyond the end of 
record. 


An index file cannot reside on 
more than one disk. 


Indicates the number of blocks 
in which parity errors were 
found. 


Input files must be of type data. 


Suggested Action 


Specify 
DUPLICATES on 
input. 


See introductory 
paragraph 
concerning SORT 
errors. 


None. 


None. 


Events 200-349 

Data Communications Errors 

These messages indicate invalid conditions encountered by the data communications sub-system. For 
full descriptions of these events see the CMS Data Communications Subsystems Reference Manual, 


form no 1090909. 


Event Number Breakdown 


200-254 Common Datacomm Messages B 90/B 900/CP 9500 

255-269 B 90 Dependent Datacomm Messages 

300-305 B 900/CP 9500 Dependent Datacomm Messages 
2032801 
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a 


Events 200-229, 231-237 


Datacomm Handler Detected Errors (For B 90/B 900/CP 9500) 


Message Format: 


mix/progname MCS ERROR 


Event Message 

200 OPERATION DENIED -— 
INVALID MESSAGE TYPE 

201 OPERATION DENIED — 
INVALID LOGICAL 
STATION NUMBER 

202 OPERATION DENIED — 
INVALID QUEUE 
REFERENCE 

203 OPERATION DENIED - 


INVALID LOGICAL SUBNET 
NUMBER 


< event no > 


es message —_ 


Possible Causes Suggested Action 


The type field in the message 
header contains a value greater 
than 12. Error is returned after 
QUEUE. 


A reference has been made to 
an LSN greater than 
STATION.COUNT-1. Error is 
returned after 
ALLOW.OUTPUT 

CLEAR 
CONTINUE.STATION 
DISALLOW.OUTPUT 
QUEUE 
REDEFINE.STATION 
ROUTE.OUTPUT 
SET.INPUT.LIMIT 
STATION.DESCRIPTION 
STATION.STATUS 


A reference has been made to 
an invalid queue. Certain 
communicates are restricted to 
certain queues, therefore the 
queue referenced may exist while 
being invalid in this context. 
Error is returned after 
CLEAR 

DEQUEUE 

QUEUE 

QUEUE.DEPTH 

RECALL 

ROUTE.INPUT 
ROUTE.OUTPUT 
SET.QUEUE. LIMIT 


A reference has been made to a 
subnet greater than 
SUBNET.COUNT-1. Error is 
returned after 

ALLOW.INPUT 


I TS oF 


205 


206 


207 


208 


2032801 


Message 


WRITE HEADER DENIED — 


TEXT LENGTH EXCEEDS 
ACQUIRED DATA COMM 
MESSAGE SPACE 


OPERATION DENIED — 
MESSAGE REFERENCE 
DOES NOT CONTAIN A 
MESSAGE POINTER 


WRITE TEXT DENIED - 
STARTING BYTE LIES 
OUTSIDE OF ACQUIRED 
DATA COMM MESSAGE 
SPACE 


OPERATION DENIED — 
INVALID MIX NUMBER 


OPERATION DENIED — 
INVALID LOGICAL LINE 
NUMBER 


(continued) 

Possible Causes 
DISALLOW.INPUT 
SUBNET.DESCRIPTION 
SUBNET.STATIONS 


The text length in the message 
header was set to a length 
greater than the message length 
field. Error is returned after 
WRITE.HEADER 


An attempt has been made to 
perform a function on a null 
message reference, that is, one 
which does not reference a 
message space. Error is returned 
after 

COPY.TEXT 

QUEUE 

READ.HEADER 
READ.TEXT 
WRITE.HEADER 
WRITE.TEXT 


The starting byte index of a text 
transfer is illegal. For the source 
message the index must be less 
than text length. For the 
destination message the index 
must be less than message 
length. Error is returned after 
COPY.TEXT 

READ. TEXT 

WRITE.TEXT 


The task number referenced is 
not currently in the mix or is 
outside the range of the mix 
table. Error is returned after 
ALLOW.INPUT 
ALLOW.OUTPUT 
CONTINUE.TASK 
DISALLOW.INPUT 
DISALLOW.OUTPUT 
SET.OUTPUT.LIMIT 
TASK.NAME 
TASK.STATUS 


The LLN reference is greater 
than LINE.COUNT-1. Error is 
returned after 

QUEUE 

LINE.DESCRIPTION 
LINE.STATIONS 


Suggested Action 
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a es 


209 


210 


211 


212 


213 


214 


215 


216 


217 
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Message 


OPERATION DENIED — 
INVALID MODEM NUMBER 


OPERATION DENIED — 
INVALID TERMINAL 
NUMBER 


OPERATION DENIED — 
INSUFFICIENT DATA 
COMM BUFFER SPACE 
AVAILABLE 


REDEFINITION DENIED — 
STATION NOT ATTACHED 


REQUESTED DATA COMM 
COMMUNICATE NOT 
IMPLEMENTED 


OPERATION DENIED — 
LIMIT NOT ALLOWED 


OPERATION DENIED — 
INVALID TALLY 


OPERATION DENIED —- 
STATION FORMAT DOES 
NOT PROVIDE REQUESTED 
TALLIES 


OPERATION DENIED — 
FUNCTION PERMITTED 
ONLY BY PRIVILEDGED 
MCS 


(continued) 
Possible Causes 


LINE.STATUS 
REDEFINE.LINE 
REDEFINE.STATION 


A reference has been made to 
an LMN greater than 
MODEM.COUNT-1. Error is 
returned after 
MODEM.DESCRIPTION 
REDEFINE.LINE 
REDEFINE.STATION 


A reference has been made to 
an LTN greater than 
TERMINAL.COUNT-1. Error is 
returned after 
TERMINAL.DESCRIPTION 
REDEFINE.STATION 


No message space is available to 
execute the communicate. Error 
is returned after 

CLEAR 

RECALL 


An attempt has been made to 
make an unattached station 
ready. Error is returned after 
QUEUE 


The last communicate issued is 
not implemented on this CMS 
system. 


Suggested Action 


A queue limit of zero has been 
specified. Error is returned after 
SET.INPUT.LIMIT 
SET.OUTPUT.LIMIT 
SET.QUEUE.LIMIT 


A tally number not in the range 
3-30 has been specified in the 
ACCESS.TALLIES 
COMMUNICATE 


The station specified in the 
ACCESS.TALLIES 
COMMUNICATE is not of type 
tallies. 


An attempt was made to 
perform an operation which is 
not allowed by a non-privileged 
MCS. 


fae eA es a eS SS ea 


219 


220 


221 


222 


223 


224 


225 


226 
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Message 


REDEFINITION DENIED — 
SPO CAPABILITY 
CONFLICTS WITH OTHER 
ATTRIBUTES 


REDEFINITION DENIED — 
STATION IS IN SCL MODE 
OR SCL MESSAGES ARE 
QUEUED 


OPERATION DENIED - 
LOGICAL STATION 
ALREADY ATTACHED 


REDEFINITION DENIED — 
INCOMPATIBLE 
ATTRIBUTES PROPOSED 


OPERATION DENIED — 
DIRECT CONNECT LINE 


OPERATION DENIED — 
FULL DUPLEX MISMATCH 


OPERATION DENIED — 
INCOMPLETE VARIABLE 


OPERATION DENIED — 
IMPROPER LINE 
CONDITION 


OPERATION DENIED — 
MESSAGES QUEUED 


(continued) 
Possible Causes 


A REDEFINE.STATION 
COMMUNICATE has been 
issued which would result in a 
station which is either 

1. SPO capable and type bits 
2. SPO capable but not myuse 
input and output 

A REDEFINE.STATION 
COMMUNICATE has been 
issued while a SPO capable 
station is in SCL mode, or has 
SCL output messages queued. 


The LLN of an attached station 
has been set to a value other 
than @FF@. Error is returned 
after REDEFINE.STATION 


The new attributes of the station 
or line are inconsistent with the 
existing network definition. Error 
is returned after 
REDEFINE.STATION 
REDEFINE.LINE 

An attempt has been made to 
assign a MODEM to a direct 
connect line. Error is returned 
after 

REDEFINE.LINE 


Attribute mismatch of full 
duplex terminal. Error is 
returned after 
REDEFINE.LINE 
REDEFINE.STATION 


The length of the parameter area 


to be used for reconfiguration is 


insufficient. Error is returned 
after 

REDEFINE.LINE 
REDEFINE.STATION 


The line being redefined is not 
in the required state of NOT 
READY and, for a switched 
line, not switched busy or not 
connected. Error is returned 
after 

REDEFINE.LINE 


Messages are queued for output 
to the station referenced by 


Suggested Action 


7-33 


SS a a ee 


Event 


22t 


228 


229 


231 


232 


233 


234 


Message 


OPERATION DENIED — 
NO VACANCY ON LINE 


OPERATION DENIED — 
SPEED MISMATCH 


OPERATION DENIED — 
QUEUE FULL 


OPERATION DENIED — 
OWNERSHIP IMPROPER 
FOR STATION OR SUBNET 
QUEUE ACCESS 


LINE OR DCP 
ALTERATION DENIED — 
ALL ASSOCIATED 
STATIONS MUST BE 
OWNED BY THE ISSUING 
MCS 


OPERATION DENIED — 
NETWORK 
RECONFIGURATION IS IN 
PROGRESS 


RELINQUISH DENIED — 
IMPROPER STATION, LINE 
OR SUBNET QUEUE STATE 


(continued) 

Possible Causes 
REDEFINE.STATION. Messages 
are queued for output to a 
station on the line referenced by 
REDEFINE.LINE. Error is 
returned after 
REDEFINE.STATION 
REDEFINE.LINE 


The MAXSTATIONS statement 
in the line section of the NDL 
defines the maximum number of 
stations which may be attached 
to a particular line. An attempt 
has been made to attach a 
station to a line which already 
has MAXSTATIONS. 


The speed specified for a station 
when either redefining the 
station or attaching the station 
to a line, does not match the 
speeds of the other stations on 
that line. 


The MCS has attempted to 
queue a message which would 
cause the queue count field of 
the station or subnet table to 
overflow. 


The MCS tried to access a 
station or subnet which it does 
not own. 


Suggested Action 


The MCS tried to attach a 
station to a switched line on 
which stations owned by a 
different MCS are already 
attached. 


The following operations cannot 
be performed at this time 
because network reconfiguration 
is taking place: 

LINE STATIONS 

STATION STATUS 


An attempt by an MCS to 
release control of a station 
cannot be accomplished for one 
of the following reasons: 

1. The station or subnet to be 
relinquished is queued. 


Su _RORORONNG OO 


Event 


235 


Message 


OPERATION DENIED - 
SPECIFIED MIX NUMBER 
DOES NOT REFER TO AN 
MCS 


OPERATION DENIED — 
STATION INPUT OR 
OUTPUT IS NOT ROUTED 
TO THIS MCS 


Event 237 reserved for future use. 


2032801 


(continued) 
Possible Causes 
2. The station is READY. 


3. The station is attached to a 


switched line. 
4. The mix number passed is 
not that of an MCS. 


An MCS has tried to relinquish 


a station/subnet to an MCS 
which is not currently in the 
mix. 


Invalid routing of message in 
multi MCS environment. 


Suggested Action 
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Events 230, 245-254 


Datacomm Loader Detected Errors 


Message Format: 


Event 
230 


245 


246 


247 


248 


249 


250 


251 


252 
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< event no > 


Message 


DC LOAD FAILURE - 
NDLSYS FILE AND DCP 
CODEFILE LEVELS ARE 
INCOMPATIBLE 


DC WARNING — SPO 
CAPABILITY OVERRIDDEN 
FOR STATIONS WITH 
INCOMPATIBLE 
ATTRIBUTES 


DC LOAD FAILURE — MCS 
IS NOT LISTED IN THE 
NDLSYS FILE 


MCS LOAD FAILURE — 
THIS MCS WAS ALREADY 
LOADED 


DC LOAD FAILURE — MCP 
VERSION AND DCP 
CODEFILE LEVELS ARE 
INCOMPATIBLE 


DC LOAD FAILURE — 
NDLSYS FILE PRIORITY 
CLASS INVALID 


DC SUBSYSTEM ERROR — 
HARDWARE ERROR 
DURING DISK ACCESS 


DC LOAD FAILURE — 
CORRUPT NDLSYS FILE 


DC SUBSYSTEM ERROR -- 
INSUFFICIENT DCP 
MEMORY 


oe = rs message — 


Possible Causes 


The data comm loader has 
detected an inconsistency between 
the NDL code file and the DCP 
code file. Possibly the DCP code 
file was not generated from this 
NDL code file. 


The station is defined as both 
SPO = TRUE and is type 
BITS, or both SPO = TRUE 
and is not MYUSE INPUT and 
OUTPUT (See MTS guide). 


An attempt was made to load 
an MCS that has not been 
identified in the NDL 
“MCSLIST”’ statement. 


An attempt was made to load 
an MCS which has the same 
name as an MCS already 
executing. 


The DCP codefile is not 
generated by an NPC900 running 
under this MCP level, so it does 
not match. 


The NDLSYS file does not have 
the correct value in the priority 
class field of the PPB 
(@3180@). 


The NDLSYS or DCP file 
cannot be read because of a 
disk I/O failure. 


The NDLSYS file either has a 
line with an invalid address for 
B 800 or specifies an amount of 
required memory which is 
insufficient for the tables and 
buffers declared. 


The memory space required field 
of the present data in the 
NDLSYS file specifies more 


Suggested Action 


6 Se a 8 a Se aS 


253 


254 


2032801 


Message 


DC SUBSYSTEM ERROR -— 
HARDWARE ERROR 
DURING CLOSE OF 
NDLSYS FILE 


DC LOAD FAILURE —- 
CANNOT OPEN NDLSYS 
FILE 


(continued) 

Possible Causes Suggested Action 
space than the MCP can 
provide. 


Performing the close 
communicate on the NDLSYS 
has failed. 


Performing the open 
communicate on the NDLSYS 
has failed. For example: 

— File is not on disk. 

— File has wrong file type. 
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B 80/B 90 Dependent Datacomm Messages 


Event 255 
Event Message Possible Causes Suggested Action 
255 DC INVALID 


The operator has entered a DC 
message when no MCS was 
running. This event does not set 
fetchvalue or fetchmessage. 


7-38 


Te 


OP i ea te SS eee 


Events 256-263 


Message format. 


<event no > 

Event Message 

256 TOO MANY SUBNETS IN 
NDL 

257 TOO MANY STATIONS IN 
NDL 

258 CANNOT ALLOCATE 
REQUIRED SPACE 

259 CANNOT EXECUTE NDL 
PROGRAM 

260 INVALID DATACOMM 
CONTROLLER 

261 TOO MANY LINES IN NDL 

2032801 


DC SUBSYSTEM ERROR 


message —_—_——_| 


Possibie Causes Suggested Action 


This event is returned and data 
comm load aborted if: 
(SUBNET.COUNT * 16) + 1 

is greater than 2000. That is, if 
there is insufficient space for the 
number of subnet queues 
defined. 


This event is returned and data 
comm load aborted if: 
(STATION.COUNT * 12) is 
greater than 2000. That is, if 
there is insufficient space for the 
number of stations defined. 


This event is returned and data 
comm load aborted if there is 
insufficient space declared in the 
NDL preset data for the system 
queue header and at least one 
message. Insufficient space is 
declared to be less than 
(STATION.COUNT + 
SUBNET.COUNT + 2) * 12 + 
176 


This occurs if the load of the 
NDL interpreter was not caused 
by an MCS load. 


This occurs if the system detects 
that a line channel/subchannel 
does not contain a valid data 
comm controller, or if the 
transmission method of the 
controller is incompatible with 
that declared for the line in 
NDL (for example, an async 
controller declared as sync in 
NDL). The load of data comm 
is aborted. 


Insufficient space has been 
allocated to the NDL interpreter 
by the MCP. Load of data 
comm is aborted. 
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a a ee es 


NOTE 
The error messages for events 262 and 263 are outside the range of B 90-de- 
pendent errors. They refer to restrictions which will be lifted in the future. 


Event Message Possible Cause Suggested Action 
262 FULL This event is returned and the 

DUPLEX load of data comm aborted if 

LINE NOT the NDLSYS contains a full 


IMPLEMENTED _ duplex line. 
263 TELEX LINE This event is returned and the 


NOT load of data comm aborted if 
IMPLEMENTED _ the NDLSYS contains a telex 
line. 


7-40 


Te a as a a SSS 


Event 269 


Event 
269 


2032801 


Message 


DC LOAD 
FAILURE — 
CODEFILE 
WAS NOT 
GENERATED 
FROM THIS 
NDL 


Possible Causes Suggested Action 


This NDL.INTERPX file is not 
the latest codefile to be 
generated by NPC90 from this 
NDLSYS. 
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B 900/CP 9500 Dependent Datacomm Messages 
Events 300-305 


Message Format 


Event 


300 


301 


303 


304 


305 
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< event no > ~ 


6s ” 


Message 


DC LOAD FAILURE - 
INSUFFICIENT DATACOMM 
BUFFER MEMORY 


DC LOAD FAILURE —- 
CANNOT OPEN SYSRECON 
FILE 


DC LOAD FAILURE —- 
CANNOT CLOSE SYRECON 
FILE 


DC WARNING — LOGICAL 
DCP number NOT LOADED 


DC LOAD FAILURE — NO 
DATACOMM PROCESSORS 
LOADED 


DC SUBSYSTEM ERROR —- 
NDLSYS FILE LINE 
ADDRESS IS NOT 
SPECIFIED CORRECTLY 
FOR THIS SYSTEM 


message —| 


Possible Causes 


The amount of memory specified 
in the SYSCONFIG file for use 
by data comm buffers is less 
than the minimum specified in 
the NDLSYS file. 


The system encountered an error 
while attempting to open the 
SYSRECON file. 


The system encountered an error 
while attempting to close the 
SYSRECON file. 


This message will be displayed 
after detection of a DCP related 
load error, to indicate that the 
DCP is in error. 


This message is displayed if no 
DCPs have been loaded. This 
condition is fatal to the data 
comm load. 


Line address in NDL is different 
from the hardware line address. 


Suggested Action 


Events 350-499 


implementation Dependent System Messages 


These messages may or may not be output depending on the specific CMS system being used. 


Unless o 
ber shown in the column called EVENT is the message’s re 


LANGUAGE. 


Events 350-369 


— Common Messages 


These messages may be output from any CMS operating system. 


Event 
350 


351 


353 


354 


355 


356 


2032801 


Message 


DISK pack-id IN DRIVE 
peripheral IS CORRUPT 
CEASE USING DISK 


DISK pack-id IN DRIVE 
peripheral SHOULD BE 
BACKED UP SOON DUE 
TO EXCESSIVE ERRORS 


NICGY nackeid IN DRIVE 


igh parwnriu 


peripheral AT END-OF- 
LIFE IF REMOVABLE, 
REPLACE DISK IF 
FIXED, INFORM 
SUPPORT PERSONNEL 


DISK pack-id IN DRIVE 
peripheral NEARING END 
OF LIFE. BACKUP 
IMMEDIATELY. 


REMOVABLE DISK IN 
DRIVE peripheral NOT 
CENTRED CORRECTLY 
(MTR DATA = number) 
RE-INSERT DISK 


DISK IN DRIVE 
peripheral CANNOT BE 
ACCESSED DUE TO 
EITHER A DRIVE 
FAILURE OR 
CORRUPTED DISK (MTR 
DATA = number) 


DISK DRIVE peripheral 
FAILURE (MTR DATA 
= number) CEASE 
USING DRIVE AND 
INFORM SUPPORT 
PERSONNEL 


Possible Causes 


Label and directory 
information could not be 
read at disk load time. 


An excessive number of 
retries is occurring on this 
disk. 


The hardware has 
automatically removed as 
many bad sectors as it has 
the capacity for. 


The hardware will shortly 
have no more room left in 
which to relocate bad 
sectors. 


Drive failed to recalibrate 
due to circumferential 
accuracy. 


Drive failed to recalibrate 
due to positional tribit 
accuracy. 


The drive failed read/write 
confidence test. 


therwise shown in the message, these messages do not output an event number. The event num- 
lative position in the MCP section of SYS- 


Suggested Action 


Try re-inserting disk, if the 
same error occurs, stop using 
this disk. 


Copy all required files from 
this disk and re-initialize the 
disk. 


Replace the disk if it is a 
floppy disk, otherwise ask for 
technical assistance. 


Copy all required files from 
this disk. If this is a floppy 
disk, replace it, otherwise ask 
for technical assistance. 


Remove and re-insert disk. 


Try another disk in the drive 
with the reported failure. If 
the drive operates with no 
reported failure, retry the 
original disk. 


Ask for technical assistance. 
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358 


359 


364 


365 


366 


367 
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Message 


DISK IN DRIVE 
peripheral MAY HAVE 
BEEN CORRUPTED 
WHILST WRITING (MTR 
DATA = number) 
CHECK CONTENTS OF 
DISK 


INVALID CONTROL 
CARD IN READER 
peripheral. REMOVE AND 
REPUNCH CARD 


DISK IN DRIVE 
peripheral IS NOT IN 
STANDARD CMS 
FORMAT 


WARNING: mix/progname 
HAS ACCESSED file- 
name WHICH IS A 
DUAL PACK FILE. 
SUCH FILES WILL NO 
LONGER BE 
SUPPORTED IN 
FUTURE RELEASES USE 
“COPY”? TO CONVERT 
FILE. 


TOO MANY SMALL 
UNUSED AREAS ON 
DISK pack-id/BECOMING 
AVAILABLE RESULTING 
IN DIRECTORY 
OVERFLOW AND LOST 
SPACE. RUN ‘‘SQ”’ 
SOON TO RECOVER 
DISK AREAS AND 
CONSOLIDATE INTO 
LARGER FREE AREAS. 


DEVICE peripheral 
LOCKED BY mix/ 
progname. USE “‘RY’’ TO 
BRING IT ON LINE 
WHEN REQUIRED 


mix/progname UNABLE 
TO PURGE WRITE- 
PROTECTED TAPE IN 
DEVICE peripheral 


(continued) 
Possible Causes 


Drive failed to: 

1. Recognize any sector 
identifiers. 

2. Detect end of sequence. 


A program from a card- 
reader cannot be executed 
due to an invalid control 
card. 


The disk label may be 
corrupted. 


In future releases dual 
pack files will no longer 
be supported, so it would 
be better to eliminate them 


now. 


It is possible for all entries 
in available table (non-file 
directory) to be in use. If 
a file then releases its disk 
Space, it may not be 
possible to enter it in the 
available table. Disk 
checkerboarded. 


A non disk device is 
closed with lock. 


An attempt has been made 
to purge a write disabled 
magnetic tape device. 


Suggested Action 


Use CHECK.DISK and KA 
to check contents of the disk. 


Remove and repunch the 
control card. 


Reformat or re-initialize the 
disk. 


Use COPY utility to convert 


the file, or run 


DUMPADISK. 


Run SQ utility. 


Run RY intrinsic to make 
ready the peripheral. 


Write enable the media. 


aN 


Events 370-399 -— B90 Dependent Messages 


Event Message 
370 ENTER DATE AS MM/DD/YY 
371 ENTER DATE AND TIME AS MM/DD/YY HHMM 
373 mix/progname priority status 
374 


e o* * * ® ® * F KR K KR K KH RK K KF 
» COMPUTER MANAGEMENT SYSTEM (CMS) 
DEVELOPMENT MCP 

VERSION version yyddd 

* INTERNAL PATCHLEVEL number 


x * * * * * * K K  * RK KH KB K KF RK ¥ 


* * & * 


* 


376 DIAGNOSTIC STOPS SET ARE hexnumber 
378 peripheral decnumber RETRIES 
379 DIAGNOSTIC LEVELS SET ARE hexnumber 


380 UNABLE TO HANDLE KEYFILE filename CREATED ON ANOTHER CMS SYSTEM 
USE “SORT” TO RECREATE KEYFILE 


381 mix/progname executing 


382  mix/progname VMERROR (VMFIL 


2032801 
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a ee 
Events 430-469, 630-634 -— B 900 System Dependent Messages 


Event . Message 
430 filename CREATED 
431 SYSTEM DUMP INITIATED 


432 SYSTEM DUMP ABORTED 
AN AVAILABLE DUMP FILE DOES NOT EXIST 


433 SYSTEM DUMP ABORTED 
DISK ERRORS WERE ENCOUNTERED 


434 filename CLOSED 


435 SYSDMFILE NOT CREATED 
DISK ERRORS WERE ENCOUNTERED ON OPEN 


436 SYSDMFILE NOT CREATED 
INSUFFICIENT DISK SPACE 


437 SYSDMFILE NOT CREATED 
MAXIMUM NUMBER OF SYSTEM DUMP FILES ALREADY EXISTS 


438 ENTER DATE AND TIME USING DT COMMAND 


439 SYSTEM I/O ERROR WHEN ACCESSING A PROGRAM STRUCTURE FOR mix/ 
progname 


440 CLEAR/START hexnumber 

441 MEMORY PARITY ERROR DETECTED AT: hexnumbers 
442 decnumber text decnumber 

443 decnumber DCP decnumber 

444 mix/progname KEYBUILD NOT FOUND 

445 mix/progname MERGER NOT FOUND 

446 mix/progname ALL INPUT RECORDS DELETED 

447 PROCESSOR decnumber LOGICALLY NOT READY 


448 mix/progname REQUIRES AN INTERPRETER WHICH IS NOT PRESENT IN ANY 
OF THE PROCESSORS 


449 mix/progname HAS REQUESTED MORE MEMORY THAN IS AVAILABLE ON THE 
APPROPRIATE TASK PROCESSORS 


450 mix/progname SWAPPED OUT. THRASHING DETECTED 
451 mix/progname EXECUTING 


452 input IGNORED — DEVICE ERROR event-no ON peripheral — THE LP 
TRANSLATION TABLE text SPECIFIED IN THE SYSCONFIG FILE CANNOT BE 
LOCATED IN FILE SYSTRANSLATE 


453 input IGNORED — DEVICE ERROR event-no ON peripheral - THE REQUESTED 
TRANSLATION TABLE text SPECIFIED IN THE SYSCONFIG FILE CANNOT BE 
ACCESSED 


454 mix/progname <454> LOC: hexnumber, FETCH.VALUE hexnumber 
455 mix/progname <455> FILE ERROR decnumber ON SORT-MERGE FILE 
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465 


466 


468 


630 
631 


632 


633 


634 


2032801 


(continued) 
Message 


text decnumber 

mix/progname event-no CANNOT OPEN filename — FILETYPE NOT DATA OR 

SOURCE 

AUTOMATIC SYSTEM RECOVERY INITIATED BY 
D BY 


TROY INTITIAT 


AU TOMATIC SYSTEM RECOVERY INITIATE 
SYSTEM DUMP CONTAINED IN FILE text 
SYSTEM DUMP COMPLETED SUCCESSFULLY 
SYSTEM DUMP INCOMPLETE 

DISK ERRORS WERE ENCOUNTERED 

END CF 

mix/progname DEVICE ERROR event-no — THE LP TRANSLATION TABLE text 


SPECIFIED IN THE SYSCONFIG FILE CANNOT BE LOCATED IN FILE 
SYSTRANSLATE WHEN ATTEMPTING verb ON FILE filename. 


mix/progname DEVICE ERROR event-no — THE REQUESTED TRANSLATION 
TABLE IN FILE SYSTRANSLATE CANNOT BE ACCESSED WHEN ATTEMPTING 
verb ON FILE filename 


mix/progname DUMP FILE NOT CREATED — A FILE NAMED pack-id DMFILmix 


merromno 


ALREADY EXISTS 


DEVICE ERROR event-no ON peripheral - THE REQUESTED TRANSLATION 
TABLE IN FILE SYSTRANSLATE CANNOT BE ACCESSED 


“PO FINAL”? IGNORED — MUST BE PRECEDED BY ‘‘PO SYSTEM”’ 


input IGNORED — THE SYSTEM SPO IS IN THE PROCESS OF POWERING 
DOWN THE SYSTEM 


input IGNORED — SPECIFIED DEVICE IS THE SYSTEM DISK — USE ‘‘PO 
SYSTEM”’ 


WARNING — PROGRAMS ARE IN THE MIX 

ENTER ‘PO FINAL’? TO TERMINATE THEM AND POWER OFF THE SYSTEM 
ENTERING ANY OTHER COMMAND WILL CAUSE THE ‘PO SYSTEM” TO BE 
IGNORED 


ERROR ENCOUNTERED WHEN ATTEMPTING TO READ THE LABEL ON 
peripheral 


A 


I 
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Events 564-567 — B 90/B 900 SDI Disk Messages 
These messages are produced when the SDI disk drive detects an error condition. 


Message syntax: 


message —_—_—_— 


peripheral hex-number 


MANDATORY INTERRUPT, MTR = 


where the hex number has the following format: 
BYTE 1 (Common information) 


Note bit 1 only applies to the 3/6 disk drive (B 9489-21/27). 


Bit 0 Disk speed incorrect. 
Bit 1 Drive servo phase offsets outwith specification. 
Bit 2 Servo fault. 


Bits 3-7 To be specified. 


BYTE 2 and BYTE 3 (Byte 2 relates to Drive 01 and Byte 3 to Drive 02) 


NOTE 
For 211 (B 9493-20/40/80) disk drive only use Byte 2. 


Bit 0 Drive failed to recalibrate successfully due to positional tribit accuracy. 
Bit 1 Drive failed to recalibrate successfully due to circumferential accuracy. 

Bit 2 Drive failed to read/write relocation table or maintenance log successfully. 
Bit 3 Drive failed to recognize any sector identifiers. 

Bit 4 Drive failed to detect end of sector sequence. 

Bit 5 Drive failed to Read/Write confidence test. 


Bits 6-7 To be specified. 


Event Message Possible Cause Suggested Action 

564 REINSERT DISK Drive failed to recalibrate Remove and reinsert disk. 
due to circumferential 
accuracy. 

565 TRY ANOTHER DISK Drive failed to recalibrate Try another disk in the drive 
due to positional tribit with the reported failure. If 
accuracy. the drive operates with no 


reported failure, then try the 
original disk. 


566 DRIVE FAILED — The drive failed to read/ Call local Burroughs support. 
SERVICE REQUIRED write confidence test. 
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Event Message 
567 DISK MAY BE 
CORRUPT 
2032801 


(continued) 


Possible Cause Suggested Action 
The drive failed to: Use another disk and if error 
1. recognize any sector recurs, call local Burroughs 
identifiers support. 
2. detect end of sector 
sequence. 
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i a es 
SUBSECTION B 

OUTPUT MESSAGES FOR B 1800/B 1900 SYSTEMS 

Events 1-6 

Software Information 


These messages are information indicating error conditions. If any operator action is required, other 
message(s) follow immediately. 


Message syntax: 


filename —————— peripheral > 
>———_ function —- message ————————_ ERROR WHILE IN verb ——— status —_+ 


mix/progname ————_ < event no > 


Where: 
function INPUT or OUTPUT. 
message given in the following table. 
verb for example, READ, WRITE. 
status gives additional information such as the disk address for disk failures. 
NOTE 
If there is an input/output error on a‘disk device during a hardware search, 
the <sector> address given is not valid, it shows where the search started 
from. The error is somewhere beyond this point. 
Event Message Possible Causes Suggested Action 
1 TAPE Ending iabei on a iabelled tape None Program has indicated it can 
FORMAT is missing or invalid. handle the error. 
2 PARITY Hard parity error found on this None. Program has indicated it can 
< status > device (disk). Non-disk, cither handle the error. 
data could not be located, or <status> shows disk sector start 
the device has a malfunction. address for disk errors. 
3 TIMEOUT For tape device, no data was None. Program has indicated it can 
< status > found for quite a distance on handle the error. 
the tape (exact length depends <status> shows disk sector start 
on unit). For disk, sector address for disk errors. 
specified could not be used. 
4 ADDRESS Sector could not be found on None. Program has indicated it can 
< status > disk (cylinder was found). handle the error itself. <status> 
Software has indicated an invalid shows disk sector start address for 
sector or sector address on disk _ disk errors. 
is corrupt. 
5 REWIND Problem encountered on tape Retry program. 
rewind. 
6 DESCRIPTOR _ Identifies I/O error that is not None. Program has indicated it can 


PARITY, TIMEOUT, ADDRESS handle the error. 
or REWIND. 


a 


Events 7-9 
Device Messages 


The event number shown for these messages is only a guide to their position in the file SYS- 
LANGUAGE, as these messages do not produce an event number in the output. 


Event Message Possible Causes Suggested Action 


7 packid/ It is possible for all entries in Run SQ utility. 
AVAILABLE available table (non-file 
TABLE FULL _ directory) to be in use. If a file 


— PLEASE then releases its disk space it 
RUN SQ may not be possible to enter it 
in the available table. Disk is 
checkerboarded. 
8 mix/progname A non disk device is closed with None. 
peripheral lock. 
LOCKED 
9 mix/progname An attempt has been made to Write enable the media. 
peripheral close purge a write disabled 
DEVICE NOT magnetic tape device. 
PURGED —- 
NO WRITE 
PERMIT 
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Events 10-19, 27-29, 39, 42, 69, 81-82, 85 And 88 

Software Suspensions 

When a running program encounters a condition that prevents it from continuing, the MCP suspends 
the program and informs the operator as to the reason for the suspension. When the condition is 
cleared, the MCP normally allows the program to continue running. If the program does not continue 
automatically, the operator should issue a ‘‘GO’’ command (see ‘‘GO”’ intrinsic) to the program. 


Message Syntax: 


mix/progname filename 


WAITING 


< event no > 


reel no 


Event Message Possible Causes Suggested Action 
10 NO FILE Disk or tape file this program Check for correct disk or tape; 
needs has not been found. supply program with backup copy 
of file requested. 
11 DUPLICATE While attempting to place a Normally, use RM or CH to 
FILE certain file on disk or tape, remove the existing file from disk. 
program has discovered a file If in doubt, refer to program 
with the same name already instructions. 
exists on the device. The For non-disk devices, either power 
program halts as more than one’ off, or save the unwanted drive. 
file with the same name cannot 
reside on the same device. 
12 NO DISK There is no more available space With KA analyse amount of 
SPACE on disk; space available is available space remaining. If the 
insufficient to hold file this disk is full, remove any unnecessary 
program is attempting to write; files and program will continue. Or, 
or disk is checkerboarded. if the disk is checkerboarded, 
terminate the suspended program 
using the DS intrinsic, then use the 
SQ utility to consolidate disk space. 
Re-execute the program that 
encountered the suspension. 
13 DIRECTORY When the disk was initialized, Use RM to remove any unnecessary 
FULL the disk directory was files and program will continue. Or, 
constructed to contain a fixed DS the suspended program. Replace 
number of file names. The disk with another disk having 
directory has now reached its sufficient directory space, and re- 
capacity. execute the program. 
14 DEVICE NOT Device that program needs in RY required device, or assign 
AVAILABLE order to continue processing is program to alternative device (see 
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either saved, not ready or in use 
by another program. 


AD intrinsic). 


80 9998900 


Event 
15 


16 


17 


18 


27 


28 


29 


39 


42 


69 


2032801 


Message 


FORMS 
REQUIRED 


GENERATION 
NUMBER 
MISMATCH 


NO FILE 


DUPLICATE 
PACK 


FILE IN USE 


DEVICE NOT 
ON SYSTEM 


DEVICE 
ASSIGNMENT 
REQUIRED 


DUAL PACK 
MISMATCH 


BAD 
FILENAME 


DISK 
LOCKED 


DISK FILE 
HEADER 
MISMATCH 


(continued) 
Possible Causes 


Program is waiting for operator 
to insert correct forms into the 
output device before it will 
continue processing. 


While opening an old indexed 
file, a discrepancy has been 
found between the generation 
fields of the keyfile and the data 
file. The operating system will 
cancel the suspension when the 
discrepancy no longer exists. 


Program needs a disk or tape 
that is not available to the 
system. 


Two or more disks or tapes 

having the same names have 

been found on-line. Only one 
disk or tape of a given name 
may be on-line at a time. 


The specified file cannot be 
opened because it has already 
been opened by the maximum 
number of users allowed for the 
desired mode of use. 


There is no device of the 
required kind present on the 
system. 


An open of an unlabelled file 
requires a device to be assigned. 


The two parts of a dual pack 
file have been found to be 
inconsistent. 


OPEN or CLOSE has detected 
an illegal special character 
imbedded in the filename. 


The disk requested by the 
program is in use by another 
program which has ‘‘locked’’ 
access of the disk. 


Possible disk or disk drive 
problem. 


Suggested Action 


Insert correct forms into output 
device. Then use AD intrinsic to 
assign device to program (see AD 
intrinsic) 

DS the program and either run the 
utility KEY.CHECK (see 
KEY.CHECK utility), or Sort the 
data file to produce a new keyfile. 
Re-execute program. 


Mount the correct media and ready 
the device using the RY intrinsic. 
Or allow program currently using 
the device to go to end of job and 
then the suspended program will 
automatically be able to use the 
device. 


Check for correct disk or tape. 
Replace or relabel one of the 
duplicates. 


Wait until the file is not in use. 


Fit requested device to the system, 
or change program so that it does 
not request this device. 


AD the required device to the 
program (see AD intrinsic). 


Check both disks contain the 
correct version of the file, replacing 
the file if mecessary. 


Use SF intrinsic. 


Wait for the disk to become 
available. 


Backup as many files as possible 
and reformat or re-initialize disk. 


_O T_T 


(continued) 
Event Message Possible Causes Suggested Action 
81 or FILE The disk containing the second Make the required file available to 


82 INCOMPLETE half of a dual pack file or the the system, as follows: 
disk containing the data file of 
an indexed pair cannot be 


located. The operating system RY the required disk (see the RY 
will cancel the suspension when intrinsic) or load the required disk 
the file is made available. onto the system. 

85 NO FILE — The tape does not have the Replace the tape with one which 
DEVICE required file. has the required file. Then AD the 
RELEASED drive to the program (see AD 

intrinsic). 

88 NO WRITE The tape is write disabled. Replace the tape with a write 
PERMIT —- enabled tape then AD the drive to 
DEVICE the program (see AD intrinsic). 


RELEASED 
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Events 20-26, 30-38, 40, 41, 79, 80, 84, 87, 89, 90 


Invalid Requests on Class A or B Communicate to MCP 


Message Syntax: 


mix/progname 


< event no > 


parameter —————> 


L_. CANNOT 


verb ae | 


>——_ filename 


message ——_—} 


These messages normally indicate program errors. The program in error should be DS’ed or DP’ed 
(see DS or DP intrinsics), if necessary. The operator should then attempt to run the program again. 
If the same error is encountered, request technical assistance. 

Event Possible Causes 


Message Suggested Action 


An illegal verb has been used in 
a communicate. The parameter 
field contains the hexadecimal 
value of the illegal verb. 


20 no message 


TH TL neT 4 tar 
IB The DST did not contain an 


index to a valid FIB. The 
parameter field contains the FIB 
segment number in decimal. 


No 
_ 
= 
v4 
2) 


22 FILE LOST The medium which contained the 
file, has been illegally, physically 
removed when it was still 


required. 


The attributes specified by the 
program are conflicting. For 
example, a write to an input 
only file. 


Replace the medium in the drive 

from which it was removed and 

ready the drive using the RY 

intrinsic. 

23 ATTRIBUTE 
MISMATCH 


24 BAD 
SEQUENCE 


The program has attempted to 
perform an invalid sequence of 
communicates. The following are 
bad sequences: 

1. A rewrite not immediately 
preceded by a successful read. 
2. An overwrite immediately 
preceded by an open or start 
communicate. 

3. An overwrite or rewrite 
preceded by a conditional read 
which failed. 

4. An overwrite after a file test 
status. 


25 


2032801 


BAD WORK 
AREA 


The work area segment specified 
within the FIB cannot be used, 


7-55 


Event 


26 


30 


31 


32 


33 


34 


35 


Message 


ILLEGAL 
KEY 


ALREADY 
OPEN 


ALREADY 
CLOSED 


BAD ADVERB 


BAD BLOCK 
OR RECORD 
SIZE 


BAD FILE 
SIZE 


BAD 
NUMBER OF 
BUFFERS 


(continued) 
Possible Causes 
either because it indicates an 
FIB segment or because it is a 
read only segment; but the 
communicate requests a data 
transfer to that segment. 


The key provided on a write 
communicate to an indexed file 
was equal to binary zero or a 
byte of @FF@. 

The communicate requested an 
open of an already open file. 


The communicate requested a 
close of an already closed file. 


The adverb to open was 
determined to be illegal for any 
of the following reasons: 

1. Myuse equal to zero. 

2. Myuse incompatible with 
device, for example input/output 
for line printer. 

3. Access mode random for non- 
disk device. 

4. Access mode not equal to 
sequential, random or stream. 

5. Shared access mode not 
random or sequential. 


The record and/or block size 
has been determined to be 
incompatible or illegal for any 
of the following reasons: 

1. Buffer or record length equal 
to zero for new disk or tape 
files. 

2. Record or buffer length 
exceeds physical block size. 

3. Buffer length not an integer 
multiple of record length. 


The maximum file size exceeds 
1048576 — 16 * number of 
sectors in an allocation unit, or 
6553 — number of sectors in 
one allocation unit, if a single 
area file. 


The number of buffers exceeds 
16. 


Suggested Action 


(a eS eS aS 


37 


38 


40 


41 


79 


80 


84 


87 


89 
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Message 
BAD DEVICE 


FILE 


el 
ct D> 
my 
ies) 


PROTECTION 
ERROR 


BAD KEY 
SIZE 


BAD LEVEL 
NUMBER 


INVALID KEY 
FILE 


BAD KEY 
POSITION 


INVALID 


COMMUNICATE 


SEQUENTIAL 
ACCESS 
BEYOND EOF 


FILE NAME 
MISMATCH 


(continued) 


Possible Causes Suggested Action 


The device requested is not 
supported by the CMS operating 
systems. 

A mismatch between the file 
type fields of the FPB and the 
DFH has been found during an 
open, or user attempted to 
access a protected file. 


A privileged user attempted to 
close lock/purge a VMFILE 
(virtual memory) or firmware file 
while the file was still in use. 


An attempt has been made to 
open an indexed file with key 
size greater than 28, or with a 
key size equal to zero and access 
not sequential input, or input/ 
output. 


The implementation number in a 
key file KFPB is greater than 
this implementation. (This is 
currently 1.) 


The MCP has detected an 
inconsistency in the format of a 
key file during an indexed open. 


The MCP has detected that the 
key for an indexed file is not 
wholly contained within the data 
record. 


A valid communicate was issued 
to the wrong device type. For 
example, test status which is 
valid for any disk file, ICMD 
file and unconditional variant 
valid for tape file, so if issued 
to a card reader, this error 
would be produced. Error may 
also be issued for other reasons. 


A sequential read has been 
attempted after notification of 
end of file. 


The tape currently in use by the 
program has the wrong name, 
perhaps due to wrong reel being 
mounted. 
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Event 
90 


7-58 


(continued) 
Message Possible Causes 


TAPE NOT 
OF 
REQUESTED 
FORMAT 


Suggested Action 
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Events 43-49 
Device Errors 


These error messages indicate terminations due to fatal device errors. These errors are normally encoun- 
tered when attempting to read disks or magnetic tapes. The program which encountered these errors 
should be DS’ed or DP’ed {see DS and DP intrinsics). The operator should then attempt to run the 
program again. If the same error is encountered the disk or tape involved should not be used until 
Burroughs Customer Service Engineering has been notified and the media have been checked. 


Message Syntax: 


filename -————————_ peripheral —_——____> 
yerb — status ae | 


mix/progname < event no > 


>———._ function ———_ Message 
Where: 


ERROR WHILE iN 


function is INPUT or OUTPUT 


verb specifies the communicate that was being performed when the error occurred — for example 
OPEN, CLOSE, WRITE. 


status is the disk sector address only produced for disk devices (B 90). 


Event Message Possibie Causes Suggested Action 
43 END OF An unexpected end of tape has 
TAPE been encountered. 
44 TAPE The end label is missing or a 
FORMAT labelled tape is invalid. 
45 PARITY A hard parity error was 


discovered by the device during 
label processing. 


46 TIMEOUT When reading a tape device no 
data was found for quite a 
considerable distance along the 
tape, the exact length is device 
dependent. For disk, the sector 
specified could not be found. 


47 ADDRESS The specified cylinder was found 
but the required sector was not 
found. Either the software has 
indicated an invalid sector or the 
disk/sector address is corrupt. 


48 REWIND A problem has been encountered 
when rewinding the tape. 


49 DESCRIPTOR Identifies an input/output error 
other than PARITY, ADDRESS 
or REWIND. 
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Events 50-68, 76 


Loader Detected Failures 


These messages indicate that the MCP failed to begin the processing of a particular program for some 
reason. The operator should correct the condition which caused the load failure and try running the 
program again. 


Message Syntax: 


Event 
50 


51 


52 


53 


34 


55 
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< event no > 


Message 


DISK NOT 
FOUND 


PROGRAM 
NOT FOUND 


FULL MIX 


NO DISK 
SPACE 


INTERPRETER 
NOT FOUND 


USER COUNT 
ERROR 


LOAD FAILURE 


Possible Causes 


The specified disk is either not 
ready, or not on-line. 


The specified program file was 
not on disk. 


The program specified cannot be 
run at the present time for one 

of the following reasons: 

1. No mix slots are available for 
a program in this priority class. 

2. Another program present will 
not allow any other programs to 
enter the mix. 


There is not enough disk space 
for the program’s Virtual 
Memory file (VMFILE) or the 
file directory of the disk has no 
entries for the creation of new 
files. 


The required interpreter is not 
on system disk with its executing 
name. 


A request to exceed the 
maximum number of concurrent 
users of a file has been 
attempted. The maximum 
number of concurrent users will 
not exceed 32. 


fileid 
fid/fileid 


aan 
m 


Suggested Action 


Check that correct disk has been 
loaded. Ready the disk with the RY 
intrinsic if it is not ready. 


Check that the correct program and 
disk name were entered and re- 
input if necessary. Ensure disk does 
contain the program required. 


Wait for a suitable time to execute 
the program, or perform an orderly 
termination of some of the current 
programs. 


Make disk space available for 
program by either removing 
unwanted files from the disk, or 
copying files not required at the 
moment to backup, then remove 
them from the disk. 


Ensure that the necessary interpreter 
(for example, BILINTERP, 
COBOLINT, SORTINTRINS) is on 
the system disk with its executing 
name. 


Wait until one or more of the 
programs currently using the file 
terminates. 


a 


Event 
56 


58 


59 


60 


61 


62 


63 


65 
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Message 


CODE FILE 
ERROR 


INVALID 
LOAD 
REQUEST 


INSUFFICIENT 
MEMORY 


MCS 
ALREADY 
PRESENT 


DUPLICATE 
PACK 


NULL MIX 
REQUIRED 


ILLEGAL 
DATA COMM 
LOAD 
REQUEST 


DISK ERROR 


SUPERUTILITY 
BUSY 


INSUFFICIENT 
REAL STORE 


(continued) 
Possible Causes 


The file type for the file 
specified was not a code file 
type. For example, the file was 
data or key file type. 


The program name specified in 
EX command was invalid. For 
example it contained too many 
characters. 


There is not enough memory 
space to hold this program’s 
Task Control Block (TCB) and 
its Program Control Block 
(PCB). 


Only one MCS can be in the 
mix at a time. 


Two or more disks/packs packs 
with the same name are on-line. 
The system requires all disks on 
ihe system to have a unique 
name. 

The specified program may only 
run in a suitable mix. A suitable 
mix is one in which only the 
datacomm, SYS-SUPERUTL and 
SPIM (if running) are present. 
Also SYS-SUPERUTL must be 
dormant. 


An NDL task can only be 
loaded as part of the data 
comm loading sequence. Any 
other attempt to load an NDL 
task will fail. 


There has been an irrecoverable 
disk error whilst attempting to 
load a program. 


An attempt has been made to 
use one of the function of SYS- 
SUPERUTIL while this utility is 
performing another function. 
SYS-SUPERUTL functions are 
IR, LB, LF, CH, KX, PD and 
RM. 


The program structure cannot be 
constructed within the amount of 
memory specified in the real 
store field in the EX intrinsic. 


Suggested Action 
Check input, correct it and re-enter. 


Check input, correct it and re-enter. 


Wait for other programs io 
terminate. If this condition persists, 
request technical assistance. 


None. 


Remove unnecessary pack or re- 
name one of the disks using the 
RL intrinsic. 


Wait for the mix to become 
suitable for execution of this 
program. 


Use the required NDL loading 
sequence. 


Use backup copy of the required 
program. If the problem continues, 
request technical assistance. 


Wait until the current SYS- 
SUPERUTIL function has 
completed before entering the 
required function. 
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(continued) 
Event Message Possible Causes Suggested Action 
66 DUAL The program requires the Do not use this program with this 
ALPHABET interpreter and MCP to support implementation of CMS. 
NOT dual alphabet or reverse 


SUPPORTED escapement and the current 
system does not. 


67 FAULTY FILE The file equate in the EX Check input and re-enter execute 
EQUATE command referenced an internal command (EX intrinsic). 

file which did not exist. 

68 DISK Another program has locked the Wait until the program holding the 
LOCKED required disk. lock on the required disk terminates 

then re-execute the required 
program. 

76 INTERPRETER The interpreter and MCP levels Copy the required interpreter from 
RELEASE are incompatible. backup media then re-execute the 
LEVEL program. 

MISMATCH 


7-62 


Events 70-75 
Run Structure Errors 


Message Syntax: 


SLICE —————-. slice number 


< event no > 


message —_— 


These messages are output to indicate failure on execution of a program. The slice number, when pres- 
ent, is only meaningful when applied to the specific implementation. It does not indicate what function 
of the virtual machine was executing. The program encountering these errors should be DS’ed or DP’ed 
(see DS and DP intrinsics) if necessary. The operator should then attempt to run the program again. 
If the same error is encountered, request technical assistance. 


mix/progname 


Event Message Possible Causes Suggested Action 

70 SEGMENT The segment number exceeds the 

OUT OF number of segments declared in the 

RANGE program. 
71 SEGMENT The length of the segment 

SIZE ERROR _ exceeds the declared size of the 

segment. 

72 STACK The amouni of coniroi stack 


OVERFLOW declared in the program has 
been exceeded during execution. 


73 STACK The specified program has 
UNDERFLOW attempted to retrieve more 
information from the control 
stack than is present. 


74 INSUFFICIENT The program has attempted to 
REAL STORE exceed the memory size specified 

at execution (load) time in the 
real store field. See EX intrinsic. 


75 PROGRAM The program has attempted to 
TOO LARGE _ exceed the physical memory size. 
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Events 100-169 
Interpreter Detected Errors 


These messages indicate that a program interpreter has encountered an error on execution of the pro- 
gram. The program in error should be DP’ed (see DP intrinsic) if necessary. The source program, ob- 
ject program, dumpfile produced by DP and any data files used by the program should be saved. The 
operator should then try to run the program again. If the same error is encountered, request technical 
assistance and supply all relevant data saved to the technician. 


Message Formats: 


mix/progname —~————_ < eventno > ———————_ source reference SEGMENT __ 


——_ segment NUM Der anes ADDRESS ——————._ offset ee ee = . 


NOTE 
Source reference information is only provided if the appropriate compiler 
contro! instruction is included during the compile: 
COBOL: Source line number 
RPG: Debug line number 
MPL: Procedure number 


Event Message Possible Causes Suggested Action 
100 COMMUNICATE MCP returned @80@ in Byte 0 
ERROR of Fetch Message on a 
communicate. 


101 COMMUNICATE MCP returned an End of File 
EOF ERROR indication in Fetch message 
(@20 10 00@) and the user has 
not specified any action if EOF 


occurs. 
102 COMMUNICATE MCP returned an I/O error 
I/O ERROR other than EOF (@20 10 00@) 


in Fetch message and user has 
not specified any action to be 
taken if error occurs. 


103 SEGMENT Interpreter detected an invalid 
NUMBER data segment number. 
ERROR 

104 WRITE Interpreter detected an attempted 
ERROR WRITE to a Read-Only Segment 

or, if COBOL, a literal. 

105 SEGMENT Interpreter, on trying to resolve 
BOUNDARY an address, has discovered that 
VIOLATION the address of the data or code 


is out of range. 
Events 106-109 reserved for further use. 
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MPL Interoreter Detected Errors 


Event 
110 


Message 
INVALID OP 


Possible Cause 


Code file has become corrupt 
or, an error exists in MPLIT 
compiler or interpreter, or an 
old level of interpreter with 


same feature not implemented. 


Events 111-114 reserved for future use. 


115 


116 


117 


118 


119 


120 


121 


2032801 


DESCRIPTOR 
ACCESS 


SEGMENT 
SIZE ERROR 


ADDRESS 
ERROR 


MESSAGE 
REFERENCE 
ERROR 


STRING 
STORAGE 
ERROR 


REMAP 
ERROR 


SUBSTRING 
ERROR 


Program tried store the fetch 
value to a non-character field; 
to convert to a non-character 
field; or to store to a self- 
relative descriptor. Or, an error 
occurred in the SETNAME 
procedure, or in the parameter 
in decimal arithmetic. Other 
possible errors are: key not 
character (8) in authenticate, 
message not character in 
authenticate, or monitor 


The length assigned at run time 
to a segment or segmap page 
must be less than equal to the 
maximum length specified, and 
the segment must not have been 
used by the program before the 
SEGMENT/SEGMAP statement 
has been encountered at run- 
time time. 


SETNAME extent error; 
identifier has become out of 
scope. 


Size of message reference field 
not divisible by 4, or illegal 
access to message reference 
field. 


Illegal destination in store string 
instruction. 


Program tried to re-map a bit 
descriptor. 


Attempt made to sub-string into 
a non-character area, or length 
of substring greater than 255, or 
substring not wholly contained 
in area being substringed. 


Suggested Action 
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(continued) 
Event Message Possible Cause Suggested Action 
122 INDEX Program tried to index a self- 
ERROR relative descriptor, or to bit 


index a self-relative descriptor. 


123 EXIT ERROR Local data returned from a 
function. 


124 CPA ERROR Error in communicate parameter 
area: for example, message 
reference expected, or character 
field of 3 bytes expected. 


125 DIVIDE Divide by zero attempted. 
ERROR 

126 ZIP ERROR Error returned after ZIP. 

127 BIT Bit field overlaps more than one 
DESCRIPTION _ byte boundary. 
ERROR 

128 FPB ERROR Error in file parameter block 


encountered, or subfield of a 
non-F.P.B. segment requested. 


129 CONTROL Control Stack overflow in 
STACK communicate instruction, or 
ERROR control stack underflow in exit 

instruction. 

130 DATA STACK _ Illegal descriptor encountered. 
ERROR Usually caused by overwriting 


descriptors on the data stack by 
data in an assignment statement, 
where the left hand side has a 
bad offset value. For example 
A(X): = VAL; where X is too 
big — this will write beyond the 
end of A and may corrupt 


descriptors. 
131 DECLARATION Size of character field greater 
MODE than 255. 
ERROR 
132 DATA Insufficient room for structure 
STRUCTURE nesting or size of character field 
ERROR greater than 255, or insufficient 


room for array bound 

evaluation, or non-character 
descriptor encountered when 
character descriptor expected. 


Events 133-139 reserved for future use. 
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— : 


COBOL/RPG Interoreter Detected Errors 


Event 
140 


141 


142 


143 


& 


146 


147 


149 
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Message 


INVALID S- 
OP CODE 


INVALID 

COPX - 
GREATER 

THAN SIZE 

OF COP 

TABLE 
ALPHANUMERIC 
FIELD TYPE 
NOT 8-BIT 
UNSIGNED 


INVALID 
EDIT MICRO 
OPERATOR 
INLINE EDIT 
MASK NOT 
CORRECTLY 
TERMINATED 


EXAMINE 
SOURCE 
FIELD 
ERROR 


EXAMINE 
PARAMETER 
FIELD NOT 
8-BIT 
UNSIGNED, 
ONE 
CHARACTER 


EXAMINE 
CONTROL 
BYTE ERROR 


148 COMPARE 
FOR CLASS 

— CLASS 

AND FIELD 
TYPE 
INCOMPATIBLE 


SUBSCRIPTED 
OR INDEXED 
SUBSCRIPTED 
OR INDEX 


Possible Cause 


Invalid S-Op-Code. Code file is 
corrupt or error exists in 
COBOL/RPG compiler or 
interpreter. 

Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG RPG compiler 
or interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 


in COBOL/RPG RPG compiler 
or interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Suggested Action 
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Event 
150 


151 


152 


158 


159 


160 


161 


162 


Message 


INDEXED/ 
SUBSCRIPT 


VARIABLE IS 


INDEXED/ 


SUBSCRIPTED 


BY MORE 
THAN 3 
VARIABLES 


FETCH 


(continued) 
Possible Cause 


Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Corrupt code file or error exists 


COMMUNICATE in COBOL/RPG compiler or 


RESPONSE 
FIELD NOT 


OF LENGTH 


3 BYTES 


INVALID 
EXAMINE 


interpreter. 


Corrupt code file or error exists 
in COBOL/RPG compiler or 


SPECIFICATION interpreter. 
Events 153-157 reserved for future use. 


PERFORM 
STACK 


UNDERFLOW 


CANNOT 
OPEN NEW 
OUTPUT 
FILE WHEN 
VALUE OF 
FILESIZE IS 
ZERO 


PERFORM 
STACK 
OVERFLOW 


NON 
POSITIVE 
SUBSCRIPT 


ARRAY 
BOUND 
VIOLATION 


Attempt to exit from a module 
when not in a called module. 
Corrupt code file or error exists 
in COBOL/RPG compiler or 
interpreter. 


Program attempted to create a 
file on disk with a filesize of 
zero. Invalid code as no records 
could ever be output to the file 
created. 


Indicates that the number of 
nested PERFORM statements 
exceeds that allowed within the 
Perform Stack at compile time 
(if not specified then the default 
value is used). If this did not 
result from programming error, 
the Perform Stack should be 
increased. 


Subscripts must be a value 
greater than zero. 


Subscript outside the upper 
bound of OCCURS clause. 


Event 163 reserved for future use. 
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Suggested Action 


Perform suitable alterations to the 
program which allow the program 
to create a file with non-zero 
filesize. 


The size of the Perform Stack may 
be increased by MODIFY utility, 
using CONTROL.STACK option to 
change the PPB (see section 4). 


Event 
164 


166 


167 


168 


169 
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Message 
TRANSLATION 


SOURCE 
ERROR 


NO STOP 
RUN 


_ ENCOUNTERED 


INVALID 
SIGN CODE 


I/O ERROR 


SORT OR 
MERGE 
ERROR 


ZIP FAILURE 


(continued) 
Possible Cause Suggested Action 


In an MPL TRANSLATE 
statement the translation text or 
translation table not of type 
character (1). 


End of code file has been 
encountered but no STOP RUN 
statement has been found. 


invalid READ/WRITE to a file 
encountered. 


An error has been encountered 
in SORT or MERGE. 


Zip of another task has failed. 
For example zipped program not 
present, zipped file is not a 
code-file. 


7-69 


Se ee ee 
Events 170-199 


Sort/Merge Information 


Message Format: 


mix/progname —— < event no > — < message > + 


The following messages may be output while SORT or SORTINTRINS are running. They will display 
the name of the program which executed or attempted to execute SORTINTRINS, the MCP event 
number and a message to explain why the event was displayed. 


Event 


170 


171 


172 


173 


174 


175 


176 


177 
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Message 


DUPLICATE 
RECORD 
record number 
ILLEGAL 


INDEX KE 


IN RECORD 
key 


RECORDS 
LOST/ 
GAINED BY 
SORT-MERGE 


number 
DUPLICATE 
RECORDS 


number 
RECORDS 
CONTAINING 
INVALID 
INDEX KEYS 


number 
DELETED 
RECORDS 


number 
RECORDS 
MERGED 


number FILES 
MERGED 


Possible Causes 


Only for keyfile creation. 
Another record in the file has 
the same key as this record. 


Only for keyfile creation. The 
Key field coniains either aii 
binary zeros or has one or more 
bytes with @FF@. This record 
will not be referenced from 


keyfile. 


Probably indicates an error in 


SORTINTRINS. 


Normal message. Tells the 
operator the total number of 
records that have duplicates. (See 


Event 170). 


Normal message. Tells operator 
the total number of records with 
invalid index keys. (See Event 


171). 


Informs the operator that a 
number of records were deleted 
as they contained only hex FF 


in every byte. 


Normal message for MERGE 
only. Tells the operator the total 
number of records merged from 


all files. 


Normal message for MERGE 
only. Tells the total number of 
files merged. Should be the same 
as the number requested in the 


Sort Spec. 


Suggested Action 


If duplicates are desired, specify 
“DUPLICATES” on input. 


None. 


See introductory paragraph 
concerning errors. 


None. 


None. 


None. 


None. 


None. 


(continued) 


Event Message Possible Causes Suggested Action 
178 SORT-MERGE SORTINTRINS was DS’ed. May See introductory paragraph 
OUTPUT FILE indicate corrupt SORT or concerning SORT errors. 
NOT SORTINTRINS programs. 
CREATED 
179 SORT-MERGE Early termination due to errors. 
ABNORMAL 
EOJ 
180 SORT-MERGE__ Exror in SORTINTRINS. See introductory paragraph 
SOFTWARE concerning SORT errors. 
ERROR <SEG 
number 
OFFSET 
number > 
181 number Only for keyfile/tagfile creation. None. 
RECORDS Tells the number of records 


REFERENCED referenced by a keyfile/tagfile. 
BY KEYFILE/ 


TAGFILE 
182 NO SORT intrinsic requires a None. 
INITIATING properly coded initiating 
MESSAGE message. This should be properly 
formatted by SORT or Sorts 
within programming languages 
such as COBOL. Probably 
indicates an attempt to execute 
SORTINTRINS directly. 
183. number Normal message. Tells operator None. 
RECORDS the number of records sorted by 
SORTED a successful data file SORT. 
184 FILE ERROR _ The message informs the See introductory paragraph 
<number > operator that an error has been _— concerning SORT errors. 
NEAR encountered within the specified 
RECORD file near the specified record 
number ON number. The <number> means: 
filename 1. EOF on output file. 2. Parity 
error on input file. 
3. EOF on Sort Workfile. 
4. Bad disk address. 
5. SORT workfile error. 
6. Input file error. 
7. Output file error. 
Except for 2, this probably 
indicates an error in 
SORTINTRINS. 
185 UNORDERED Files to be merged did not have SORT files for correct order, then 
MERGE an increasing/decreasing key retry. 
INPUT FILE value. Either the file is incorrect 
2032801 
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Event 


186 


187 


188 


189 


193 


194 


195 


196 


197 
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(continued) 
Message Possible Causes 


filename NEAR or the key position has been 


RECORD incorrectly specified. 

number 

TOO MANY Machine dependent limitation. 

RECORDS 

FOR SORT- 

MERGE 

DUPLICATE DUPLICATES was not specified 

RECORDS —- on input and they were found to 

KEYFILE NOT exist. This message age will be 

BUILT displayed and no keyfile will be 
built. 

INITIATING Initiating message supplied to 

MESSAGE SORTINTRINS is not in proper 

NOT VALID format. This could be caused by 
a fault in the program that 
zipped the SORTINTRINS. 

SORT-MERGE Normal message to inform the 

version operator which version of the 

INITIATED SORTINTRINS is in use and by 

FROM mix which program. 

number/ 

program name 

INPUT For a merge sort, the input files 

RECORD do not have the same record 

SIZES size. The offending file is 

UNEQUAL - named. 

BAD FILE 

filename 

IN/OUT The output file been specified 

RECORD with a record size different to 

SIZES BAD — that of the input file. This has 

OUTPUT SIZE been corrected automatically. 

CHANGED 

BAD The output file buffer size must 

RECORD/ be less than 32768 for disk file. 

BLOCK SIZE 

FOR OUTPUT 

DEVICE 

KEY OVER- Key limit is beyond the end of 

RUNS record. 

RECORD END 

CANNOT An index file cannot reside on 

SPLIT INDEX more than one disk. 

FILE 


Suggested Action 
See introductory paragraph 


concerning SORT errors. 


Specify DUPLICATES on input. 


See introductory paragraph 


concerning SORT errors. 


None. 


None. 


i 


(continued) 

Event Message Possibie Causes Suggested Action 
198 number Indicates the number of blocks 

PARITY in which parity errors were 

BLOCKS found. 
199 INDEX SORT Input files must be of type data. 

INPUT FILE 

NOT TYPE 

DATA 
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Events 200-349 
Data Communications Errors On B 1000 Systems 
These messages indicate invalid conditions encountered by the data communications sub-system. For 


full descriptions of these events see the CMS Data Communications Subsystem Reference ey, 
form 1090909, 


Event Number Breakdown 
200-254 Implementation Independent Errors 
272-274 Implementation Independent Errors 
282-284 Implementation Independent Errors 
285-299 B 1800 Dependent Errors 
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Events 200-247 


Message Format: 


—— <eventno>—— DC ERROR message — 
Event Message Possible Causes Suggested Action 
200 DC ERROR The type field in the message 
BAD MSG header contains a value greater 
TYPE than 12. Error is returned after 


201 DC ERROR 
BAD LSN 


202 DC ERROR 
BAD QUEUE 
REF 


203 DC ERROR 
BAD SUBNET 
NO 


204 DC ERROR 
TEXT SIZE 
TOO BIG 


2032801 


QUEUE. 


A reference has been made to a 
Logical Station Number (LSN) 
greater than STATION.COUNT- 
1. Error is returned after: 
ALLOW.OUTPUT 

CLEAR 

CONTINUE.STATION 
DISALLOW .OUTPUT 

QUEUE 

REDEFINE.STATION 
ROUTE.OUTPUT 
SET.INPUT.LIMIT 
STATION.DESCRIPTION 
STATION.STATUS 


A reference has been made to 
an invalid queue. Certain 
communicates are restricted to 
certain queues, therefore the 
queue referenced may exist while 
being invalid in this context. 
Error is returned after: 
CLEAR 

DEQUEUE 

QUEUE 

QUEUVE.DEPTH 

RECALL 

ROUTE.INPUT 
ROUTE.OUTPUT 
SET.QUEUE.LIMIT 


A reference has been made to a 
subnet greater than 
SUBNET.COUNT-1. Error is 
returned after: 

ALLOW.INPUT 
DISALLOW.INPUT 
SUBNET.DESCRIPTION 
SUBNET.STATIONS 


The text length in the message 
header was set greater than the 
message length field. Error is 
returned after: 
WRITE.HEADER 
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Event 


205 


206 


207 


208 


209 
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Message 


DC ERROR 
NULL MREF 


DC ERROR 
BYTE INDEX 
TOO BIG 


DC ERROR 
BAD TASK 
NO 


DC ERROR 
BAD LINE 
NO 


DC ERROR 
BAD MODEM 
NO 


(continued) 
Possible Causes 


An attempt has been made to 
perform a function on a null 
message reference, that is, one 
which does not reference a 
message space. Error is returned 
after: 

COPY.TEXT 

QUEUE 

READ.HEADER 
READ.TEXT 
WRITE.HEADER 
WRITE.TEXT 


The starting byte index of a text 
transfer is illegal. For the source 
message the index must be less 
than text length. For the 
destination message, the index 
must be less than message 
length. Error is returned after: 
COPY.TEXT 

READ.TEXT 

WRITE.TEXT 


The task number referenced is 
not currently in the mix or is 
outside the range of the mix 
table. Error is returned after: 
ALLOW.INPUT 
ALLOW.OUTPUT 
CONTINUE.TASK 
DISALLOW.INPUT 
DISALLOW.OUTPUT 
SET.OUTPUT.LIMIT 
TASK.NAME 
TASK.STATUS 


The Logical Line Number (LLN) 
reference is greater than 
LINE.COUNT-1. Error is 
returned after: 

QUEUE 

LINE.DESCRIPTION 
LINE.STATIONS 
LINE.STATUS 
REDEFINE.LINE 
REDEFINE.STATION 


A reference has been made to a 
Logical Modem Number (LMN) 


greater than MODEM.COUNT-1. 


Error is returned after: 


Suggested Action 


Event 


210 


211 


212 


214 


218 


219 


220 


221 
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Message 


DC ERROR 
BAD 
TERMINAL 
NO 


DC ERROR 
NOSPACE 


DC ERROR 
STATION 
NOT 
ATTACHED 


DC ERROR 
COMM NOT 


IMPLEMENTED 


DC ERROR 
LIMIT NOT 
ALLOWED 


DC ERROR 
SPO 
ATTRIBUTE 
MISMATCH 


DC ERROR 
IMPROPER 


SPO STATION 


CONDITION 


DC ERROR 
STATION 
ALREADY 
ATTACHED 


DC ERROR 
ATTRIBUTE 
MISMATCH 


(continued) 
Possible Causes 
MODEM.DESCRIPTION 
REDEFINE.LINE 
REDEFINE.STATION 


A reference has been made to a 
Logical Terminal Number (LTN) 
greater than 
TERMINAL.COUNT-1. Error is 
returned after: 
TERMINAL.DESCRIPTION 
REDEFINE.STATION 


No message space is available to 
execute the communicate. Error 
is returned after: 

CLEAR 

RECALL 


An attempt has been made to 
make an unattached station 
ready. Error is returned after: 
QUEUE 


The last communicate issued is 
not implemented on this CMS 
system. 


A queue limit of zero has been 
specified. Error is returned after: 
SET.INPUT.LIMIT 
SET.OUTPUT.LIMIT 
SET.QUEUE.LIMIT 


A REDEFINE.STATION 
COMMUNICATE has been 
issued which would result in a 
station that is either 

1. SPO capable and type bits or 
2. SPO capable but not MYUSE 
INPUT and OUTPUT. 


A REDEFINE.STATION 
COMMUNICATE has been 
issued while a SPO capable 
station is in SCL mode, or has 
SCL output messages queued. 


The LLN of an attached station 
has been set to a value other 
than @FF@. Error is returned 
after: 

REDEFINE.STATION 


The new attributes of the station 
or line are inconsistent with the 
existing network definition. Error 


Suggested Action 
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Event 


222 


223 


224 


225 


226 


227 


228 
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Message 


DC ERROR 
DIRECT 
CONNECT 
LINE 


DC ERROR 
FULL 
DUPLEX 
MISMATCH 


DC ERROR 


INCOMPLETE 


VARIABLE 


DC ERROR 
IMPROPER 
LINE 
CONDITION 


DC ERROR 
MESSAGES 
QUEUED 


DC ERROR 
NO 
VACANCY 
ON LINE 


DC ERROR 
SPEED 
MISMATCH 


(continued) 
Possible Causes 
is returned after: 
REDEFINE.STATION 
REDEFINE.LINE 


An attempt has been made to 
assign a MODEM to a direct 
connect line. Error is returned 
after: 

REDEFINE. LINE 


Attribute mismatch of full 
duplex terminal. Error is 
returned after: 
REDEFINE.LINE 
REDEFINE.STATION 


The length of the parameter area 
to be used for reconfiguration is 


insufficient. Error is returned 
after: 


atwee 


REDEFINE.LINE 
REDEFINE.STATION 


The line being redefined is not 
in the required state of NOT 
READY and, for a switched 
line, not switched busy or not 
connected. Error is returned 
after: 

REDEFINE.LINE 


Messages are queued for output 
to the station referenced by 
REDEFINE.STATION. Messages 
are queued for output to a 
station on the line referenced by 
REDEFINE.LINE. Error is 
returned after: 
REDEFINE.STATION 
REDEFINE.LINE 


The MAXSTATIONS statement 
in the line section of the NDL 
defines the maximum number of 
stations which may be attached 
to a particular line. An attempt 
has been made to attach a 
station to a line which already 
has MAXSTATIONS. 


The speed specified for a station 
when either redefining the 
station or attaching the station 
to a line, does not match the 
speeds of the other stations on 
that line. 


Suggested Action 


CLUE EEEEI IIIS 


(continued) 
Event Message Possible Causes Suggested Aciion 


229 DC ERROR The MCS has attempted to 
QUEUE FULL queue a message which would 
cause the queue count field of 
the station table or subnet table 
to overflow. 


230 DC ERROR The data comm loader has Re-NPC the NDL code file to 
NDL DCP detected an inconsistency between produce a consistent DCP code file. 
MISMATCH the NDL code file and the DCP 

code file. Possibly the DCP code 
file was not generated from this 
NDL code file. 


231 DC ERROR The MCS tried to access a 


ACCESS station or subnet which it does 
DENIED not own. 

232 DC ERROR The MCS tried to attach a 
DENY station to a switched line on 
MULTIPLE which stations owned by a 
OWNERSHIP different MCS are already 

attached. 

233 DC ERROR Reconfiguration in progress 
RECON 
PENDING 

234 DC ERROR An attempt by an MCS to 
INVALID release control of a station 


RELINQUISH — cannot be accomplished for one 
of the following reasons: 
1. The station or subnet to be 
relinquished is queued. 
2. The station is READY. 
3. The station is attached to a 
switched line. 
4. The mix number passed is 
not that of an MCS. 


235 DC ERROR An MCS has tried to relinquish 


MCS NOT a station/subnet to an MCS 
RUNNING which is not currently in the 
mix, 

236 DC ERROR Invalid routing of message in 
BAD multi MCS environment. 
ENVIRONMENT 

245 DC ERROR The station is defined as both 
SPO SPO = TRUE and is type 


CAPABILITY _ BITS, or both SPO = TRUE 
OVERRIDDEN and is not MYUSE INPUT and 
FOR OUTPUT. 

STATIONS 

WITH 
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Event 


246 


247 
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(continued) 


Message Possible Causes Suggested Action 
INCOMPATIBLE 
ATTRIBUTES 
DC ERROR An attempt was made to load 
INVALID an MCS that has not been 


MCS NAME identified in the NDL 
““MCSLIST”’ statement. 


DC ERROR An attempt was made to load 

MAX THIS an MCS which has the same 

MCS name as an MCS already 
executing. 


Events 249-254 


Message Format 


—— <event no> DC LOAD/EOJ FAILURE message ——-——————_ 
Event Message Possible Causes Suggested Action 

249 DC LOAD/ The NDLSYS file does not have 
EOJ FAILURE the correct value in the priority 
BAD NDL class field of the PPB 
PRIORITY (@3180@). 

CLASS 

250 DC LOAD/ The NDLSYS or DCP file 
EOJ FAILURE cannot be read because of a 
DISK ERROR | disk I/O failure. 

251 DC LOAD/ The NDLSYS file either has a 
EOJ FAILURE line with an invalid address for 
NDL DATA B 800 or specifies an amount of 
ERROR required memory which is 

insufficient for the tables and 
buffers declared. 

252. DC LOAD/ The memory space required field 
EO] FAILURE of the preset data in the 
INSUFFICIENT NDLSYS file specifies more 
MEMORY space than the MCP can 

provide. 

253 DC LOAD/ Performing the close 
EOJ FAILURE communicate on the NDLSYS 
CANNOT has failed. 

CLOSE NDL 
FILE 

254 DC LOAD/ Performing the open 
EOJ FAILURE communicate on the NDLSYS 
CANNOT has failed. For example: 

OPEN NDL 1. File is not on disk. 
FILE 2. File has wrong file type. 
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Events 272-274 


Message Format: 


— <eventno> —— DC ERROR 


Event Message 


212 DC ERROR 
PROCESSOR 
NUMBER 
INVALID 


273 DC ERROR 
PROCESSOR 
BUSY 

274 DC ERROR 
PROGRAM 

FILE NAME 


T 
i 
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message —— 


Possible Causes 


A Load/Reload request specifies 
an invalid DCP. 


A reload specifies a DCP which 
is busy. 


The DCP file name specified in 
the reload is not defined in the 
NDLSYS file. 


Suggested Action 


Events 282-284 


Message format 


———— <eventno > ———————————_ DC LOAD /EOJ FAILURE ———-———_ message ————_—_ 
Event Message Possible Causes Suggested Action 
282 DC LOAD/ Performing a close communicate 
EOJ FAILURE on the DCP file has failed. 
CANNOT 
CLOSE DCP 
FILE 


283 DC LOAD/ Performing the open 
EOJ FAILURE communicate on the the DCP 


CANNOT has failed for one of the 
OPEN DCP following reasons: 
FILE 1. The file is not on disk. 


2. The file has a bad file type. 
3. The file is larger than DCP 


memory. 
284 DC LOAD/ The specified DCP has not been 
EO] FAILURE © warmstarted: 
DC number 
NOT ON 
SYSTEM 


28 
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Events 285-286 


Event 
285 


286 
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Message 


ERROR 
number ON 
DC number 


DC LOAD 
FAILURE — 
SPO LINE 
REFERENCED 
IN NDL 


Possible Causes Suggested Action 


An error has occurred on on 
the DC processor indicated. 


NDL specifies a physical line 
address which is the SPO line 
— this is not permitted. 


Events 350-499 
Implementation Dependent System Messages 


These messages may or may not be output, depending on the specific CMS system being used. 


Unless otherwise shown in the message, these messages do not output an event number. The event num- 
ber shown in the Event column is the message’s relative position inside the MCP section of SYS- 
LANGUAGE. 
Events 350-369 
These messages may be output from any CMS operating system. 
Message format: 
—— peripheral mfid/fileid message —— 
Event Message Possible Causes Suggested Action 
350 BAD DISK — _ Label and directory information Try re-inserting disk. 
CANNOT BE could not be read at disk load 
LOADED time. 


351 SHOULD BE An excessive number of retries Copy all required files from this 


REINITIALIZED are occurring on this disk. disk and reinitialize the disk. 
SOON 

352 BAD DISK — _ The hardware has automatically Replace the disk if it is a floppy 
RELOCATION removed as many bad sectors as_ disk, otherwise contact local 
TABLE FULL it has the capacity for. Burroughs support. 

353 EXPIRING —_ The hardware will shortly have Copy all required files from this 
BACK-UP no more room left in which to disk. If this is a floppy disk 

store bad sectors. replace it, otherwise contact local 


Burroughs support. 
Events 354-369 Reserved for future use. 


Events 470-499 


Event Message 

470 CANNOT READ LABEL ON peripheral 
471 AVR FAILURE ON peripheral 

472 peripheral NOT CMS DISK 

473 peripheral NOT STANDARD LABEL 
474 peripheral WRONG DENSITY 

475 peripheral NO WRITE PERMIT 

476 LT REQUIRED FOR peripheral 

477 peripheral UNIT CHECK 
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Event 
478 


479 


480 
481 
482 


(continued) 
Message 


mix/progname <478> filename peripheral RESULT DESCRIPTOR ERROR WHILE 
IN verb RD = hex-number hex-number DISK ADDRESS = hex-number 


mix/progname <479> filename peripheral FILE BOUNDARY VIOLATION ERROR 
WHILE IN verb DISK ADDRESS = hex-number 


SYSTEM DISK PO’ED 
LOAD FAILURE ON filename INTERPRETER TABLE OVERFLOW 
ENTER TIME AS HHMM 


Events 483 to 499 reserved for future use. 
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SECTION 8 
B90 DEPENDENT SYSTEM SOFTWARE 


INTRODUCTION 


This section covers those items in the CMS software which are operationally different on the B 90 series 
from other CMS implementations. These differences are mainly a result of the different hardware fea- 
tures involved. The software covered includes: 


Powering the B 90 on and off. 

The B 90 CMS Warmstart and Coldstart ‘‘bootstrap’’ feature. 
Stand-Alone Utilities (SAU), operating without MCP control. 
COLDSTART utility, operating without MCP control. 
Loading the MCP. 

Particular features of the B 90 MCP. 

Taking memory (system) dumps. 

B 90 system errors and symptoms. 

Utilities released only for B 90. 

Intrinsics released only for B 90. 


POWER ON 


Ensure no disks, tapes or cassettes are in the system (failure to do this may result in subsequent media 
corruption). Ensure the fixed disk is powered off. 


Turn the system power on. It is then under the control of ROM which performs a mini-test of critical 
machine components to verify it is capable of starting. The successful completion of this test is verified 
by the PK lights lighting and then turning off sequentially, with PK1 and PK2 remaining lit. 


For ROM levels less than 5, PK1 permits the loading of a cassette into the system. Some examples 
of cassettes to load would be: 
1. AE 500 firmware to cause the B 90 to perform as an AE 500, or 
2. ACSYS SLS5 emulator firmware cassettes to cause the B 90 to process Series L cassette programs 
on disk. 
B 90 cassette loads are not used in CMS. 


For ROM level 5, PK1 permits loading of the utility COLDSTART from coldstart medium (see COLD- 
START utility for a full description). 


PK2 permits the loading of information from a disk into the system. Some examples of disks to load 
would be: 

1. ACSYS (SL5 emulator) firmware disks, or 

2. CMS disks to cause the B 90 to load CMS firmware. 


NOTE 
ACSYS (SL5 emulator} can only be run on a console system. 
Load the CMS disk in any available disk drive. 


A 1 MB BSMD mini-disk is considered loaded immediately the drive unit door is closed, and the blue 
indicator is lit (disk properly inserted and up to speed). For MCP control, the disk must be write- 
enabled (red indicator lit). 
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For a 3 MB BSMII mini-disk, wait until the drive has calibrated, and the white number indicator is 
lit. For MCP control, the disk must be write-enabled (red indicator lit). 


For cartridge disk, wait about 20 seconds for the cartridge to come up to speed (a click is heard as 
the heads access the disk). Ideally, they should be run initially for a few minutes before use to achieve 
the correct running temperature. For MCP control, the disk must be write-enabled. 

For fixed disk, wait until the ‘READY’ half of the ““BUSY/READY”’ button is on. 


Depress PK2 to enter CMS Bootstrap Mode (see below). The various states, including Initial State and 
Bootstrap Mode, are shown in figures 8-1 and 8-2. 


Possible errors in the power-on sequence are given later in this section under System Load Errors. 
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Figure 8-1. B 90 Warmstart ROM Level 4 
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Figure 8-2. B90 Coldstart and Warmstart ROM Level 5 
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CMS BOOTSTRAP MODE 


From the Initial State, depression of PK2 initiates a ROM load routine which searches through all pres- 
ent disks until it finds the bootstrap code. Refer to ROM Scanning Algorithm for details of the search 
algorithm. 


Successful load of CMS bootstrap: PK3 through PK6 will be lit, to provide the following facilities: 
PK3 — warmstart MCPX. 
PK4 — dump contents of memory to magnetic tape (ROM level 5 only). 
PKS — dump contents of memory to disk. 
PK6 — enter Stand-Alone Utilities (SAU). 
Forcing System Initialization 


When the system hangs (that is, it is not performing any functions or responding to any input from 
an operator, but has not returned to the initial state), it is necessary to force the system to initialize. 


This is done by pressing the Load Enable button in the main cabinet. Never switch the cabinet off, 
or unload disks or cassettes in use, as this can cause media corruption of various kinds. 


If the correct procedure is followed, then although disk or cassette files may be only partially created 
or updated, the system when recovered should still be able to access the media. 
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COLDSTART (B 90 ONLY) 


The principal function of this utility is to load files from Coldstart media to a 211 fixed disk in CMS 
format on a B 90 consoleless system. As the 211 has to be in CMS format, the COLDSTART utility 
provides an option to initialize the highest 211 drive on the highest channel of the B 90 consoleless 
system. 


The Coldstart medium may be one of the following: 


1. 1 MB disk with COLDSTART bootstrap. 
2. BSMII (3/6 disk) with COLDSTART bootstrap. 
3. Magnetic tape in LD format, with the Tape name ‘‘CLDSTRT’”’. 


All the above must contain COLDSTART utility and CMSBOOT. Additional files are contained in 
the above as required. 


Restrictions on Use 


1. The system ROMs must support the COLDSTART utility. A minimum of level 5 ROM is re- 
quired to support the Customer utility for use on a B 90. 


2. Coldstart tapes can be produced on B 90s, B 900s or B 1900s. However, on a B 900, files 
should not be dumped from an unrestricted pseudo-pack, as the COLDSTART utility will not 
be able to load such tapes. 


3. Dual pack files cannot be handled by COLDSTART. If the COLDSTART encounters a dual 
pack file, it halts and informs the operator via a non-fatal error message. To continue loading 
the rest of the files, the operator is required to press the RESET key. 


4. Multi-reel tape cannot be handled by COLDSTART. If a multi-reel tape is loaded, the utility 
loads the files from the first reel until it reaches the last file. It will not load the last file, since 
part of the file will be on the next reel. This results in a fatal error. The COLDSTART utility 
can handle an unlimited number of single-reel tapes; that is, tapes which do not have a file 
which is continued on another tape, during one execution of the utility. 


Creation of a Coldstart Tape 

The coldstart magnetic tape must be in LD utility format and called ‘““CLDSTRT’’. 

For reasons of efficiency, it is recommended that CMSBOOT be the first and COLDSTART the second 
file on the tape. However, the ROM, BOOTSTRAP and COLDSTART utility scans along the tape 


for these files. 


When dumping files to tape using the CMS utility LD, all the files to be dumped must reside on the 
same disk. This may or may not be the system disk. 


Ensure that a purged magnetic tape is on line. 
Use LD with the initiating message below to dump the files. 
LD DUMP PRINT.DIR FROM <disk-name> TO CLDSTRT CMSBOOT, COLDSTART, 


< file-list > 
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Snecification of PRINT.DIR in the initiating message causes an accurate tape directory print to be pro- 
duced at the end of the dump. This directory, whether produced by LD or TAPELR, contains useful 
information including file names and file numbers. Since the COLDSTART utility communicates with 
the operator through the MTR keyboard, it is only able to display file numbers, not file names, when 
encountering an error. 


If the files are being dumped from the system disk, the FROM <disk-name> part can be omitted 
from the initiating message. 


The above initiating message causes the files CMSBOOT and COLDSTART to appear first and second, 
followed by the other files specified, on the tape. 


If the files contained in <file-list > contain CMSBOOT and/or COLDSTART, a warning message of 
the form: 


DUPLICATE — <file-name> ALREADY BEING DUMPED 


will be displayed for each of CMSBOOT and/or COLDSTART. These messages can be ignored. 


NOTE 
Only single reel tapes can be handled by the COLDSTART utility. Also log 
files will not be dumped to a coldstart tape. 


For further details, refer to the LD utility. 
Creation of a Coldstart Disk 


A coldstart disk is made in one of the following ways: 


1. Use the Cl function in the B 90 SAU which initializes the disk in the normal manner for that 
type of disk. CI then writes the coldstart bootstrap, from CMSBOOT, into track zero of the 
disk. 


2. Use the RF or IN option in DSKUTL with ‘“<COLDSTART>’’, on a B 90, specified in the 
initiating message. The RF or IN option performs as before, except that the coldstart bootstrap, 
from CMSBOOT, is written to track zero of the disk. 


3. The methods described above cause the loss of any files present on the disk. By using the 
BOOT option in DSKUTL, with ‘““<COLDSTART>”’ in the initiating message on a CMS 
standard disk, the bootstrap in track zero of the disk is replaced by the coldstart bootstrap 
without the loss of any files on the disk. 

NOTE 
The file CMSBOOT must be version 3.04 or greate:. Also, all the above 
methods must be carried out on a B 90 system. 


For further information and syntax, refer to the relevant utility. 


The COLDSTART utility and CMSBOOT are now copied to the disk, which has a coldstart bootstrap, 
along with the required files. 
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Outline of COLDSTART Utility 


(PKs displayed on BANK 2) 


M/C Initialized 


Load Coldstart Media 


PK1 and PK2 lit 


PK3 and PK7 lit 


PK3 pressed PK7 pressed 


Initialize highest 211 drive on highest channel. 
During initialization, PKs 1 thru 4 on bank 4 
will flash. 


Load ail files from tape or disk to the highest 
211 drive. on the highest channel, in CMS 
format. Remove duplicate files. During loading, 
the activity light will be illuminated. 


PK3 and PK4 lit 


Load next tape or disk on the PK4 pressed 
same drive before pressing 
PK3. 


Figure 8-3. Outline of COLDSTART Utility 
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Initialization Parameters for 211 Fixed Disk 


If the 211 is to be initialized, the following pre-defined set of parameters is used : 


Disk name 
Number of files 


Date 
Owner 


SYSTEM 


500 — 5MB (Allocation Unit 1) 


750 — 10MB (Allocation Unit 1) 
1000 — 20MB (Allocation Unit 2) 
2000 — 40MB (Allocation Unit 4) 
2804 - 80MB (Allocation Unit 8) 


W/M/11 
CMSB90 


Serial number 111111 


NOTE 


The coldstart media must contain the file ‘““CMSBOOT”’ (release 3.04 or 
greater) if the initialize option is required. 


Error Messages 


If, during the initialization of the 211 fixed disk or during the loading of the files onto the 211, any 


errors occur, the error light on BANK 6 is illuminated. BANK 4 displays the error number. 


EMG Vw vane 


All non-fatal errors are signified by only one light illuminated on BANK 4. The file number is also 
displayed on BANK 2 in binary for non-fatal errors. 


Fatal error numbers are displayed on two or three lights on BANK 4. The error messages displayed 
on BANK 4 are as follows (X represents a light illuminated): 


Bank 4 Lights 
12345678 
XOO0OO0O0O0O00 


Oxo0o0o0000 


XXOO0OO0OO0O00 
OOoOxo0o0O0oO00 
XxOXOOO0OO0O 
OxxO0O0000 
XXXOOO0OO0OO 


o0o0xKOaO000 
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Description 


Read error on Coldstart 
medium 


Blocksize in label is smaller 
than expected (Magnetic tape 
only) 

Corrupt directory on I/P 
(Disks only) 


Temporarily Not Available 
(BSMDII only). 


No CMSBOOT file found on 
Coldstart media. 


Tape not LOAD/DUMP 
format (Magnetic tape only). 
Directory I/O error on I/P 
(Disk only) 


File not present on tape but 
appears in directory of tape. 


Recovery 


See note 1 


See note 1 


- See note 2 


See note 1 


See note 2 


See note 2 


See note 2 


See note 1 
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(continued) 
Bank 4 Lights Description Recovery 
12345678 
XOOXKOOOO No tape named ‘‘CLDSTRT”’ See note 2 
on-line (Magnetic tape only). 
OxXOXKOOOO Coldstart medium that the See note 2 
bootstrap informed the utility 
to load from is not available. 
XXOXOOOO Coldstart medium device See note 2 
controller problem. 
OOxXKXOOOO Read error while reading See note 2 
CMSBOOT. 
XOXXKOOOO Multi-reel tape loaded. If this See note 2 
is the first reel of a multi-reel 
tape, all the files (except the 
last file, which will overlap 
onto the next reel), will be 
copied. 
OxXXxXxXOOOO Disk bad — in ‘“‘DANGER’”’ See note 2 
state (BSMDII and 5.25 inch). 
XXXXOOOO Disk expiring (BSMDII and See note 2 
5.25 inch). 
O000KO00 Read error on 211. See note | 
OO0O00O0xO00O Cannot allocate required areas. See note | 
OO0OO0O0OxKxX OO Initialize was not required, but See note 2 
no CMS standard 211 on-line. 
OO0O0000KO Areas wrong for output. See note 1 
OOO0OOXOxXO Mandatory interrupt on 211. See note 2 
O0O0Q0KXO Name list full. See note 2 
OO0OO0OOKXxXO Directory I/O error on 211. See note 2 
OO00000X Cannot load dual pack files. See note 1 
OOO0OOXKOOX Device Error : See note 2 
Drive inoperable 
Disk not present 
211 switched off after 
initialization. 
OO00O0XKOX Output failure — Bootstrap See note 2 
not copied 
OOO0OOXK XOX Disk Bad — 211 in See note 2 
“DANGER” state. 
OOOOXKOXKxX 211 fixed disk expiring. See note 2 
OO0O00O0XKXX 211 fixed disk device See note 2 


controller problem. 


a 
NOTE 1 — Non-fatal Error Handling 


To continue with the loading of files, the user must press the RESET key after noting the file number 
displayed on BANK 2 (see below). The file which was being loaded when the error occurred is removed 
from the 211 fixed disk and the COLDSTART utility goes on to the next file on the tape or disk. 
If the utility fails to load a file which would be a duplicate, the original copy of the file remains on 
the 211 fixed disk. 


The file number of the file in error is displayed, in binary, on BANK 2 of the MTR keyboard. (The 
file number is reset to zero for each new disk/tape presented to the utility for loading.) In the event 
of the file number exceeding 255, the file number is given mod 256. 


Example: If BANK 2 displays the following: 
12345678 
O0O0OO0OKXKOO BANK 2 

MSD _ Ls LSD 
(where X represents an illuminated PK) 


This implies that an error occurred when reading or writing file 12. 


To find the name of the file, refer to a directory listing for the tape or disk. Tape directories can 


be produced by LD at dump time or by TAPELR or TAPEPD. Disk directories can be produced by 
PD, KA, LR or by the LS option in SAU. 
NOTE 2 — Fatal Error Handling 


To clear the fatal error, the user is required to press the initialization button to terminate the utility 
and return to the initial state with PK lights 1 and 2 on BANK 2 illuminated. 
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STAND-ALONE UTILITIES (SAU) 


SAU contains the necessary functions to prepare a disk for use on the B 90. These functions are used 
to initially transfer system software (MCP, interpreters, utilities and compilers) to a new disk (provided 
a removable media disk drive is present on the system) at a new installation, or to install a new level 
of system software at an existing installation. 


SAU provides the facility to initialize (IN) or reformat (RF) disks and to copy (COPY) files from disk 
to disk. 


SAU functions are loaded into memory from disk and operate independently of the MCP. 
Loading Stand-Alone Utilities 


From the initial state (PK1 and PK2 lit), ensure there is a disk containing SAU on the system. Press 
PK2, which loads the Warmstart Bootstrap (see ROM Scanning Algorithm, level 4 or 5). PKs 3 through 
6 will be lit when the Warmstart Bootstrap is loaded. 


Press PK6. The system will search for a disk file called SAU. For details of the search algorithm used, 
refer to Warmstart Bootstrap Scanning Algorithm. 


For failures in search, see System Load Errors. 


SAU from a Console 


If the system has a console, SAU uses the console printer to display messages and the console keyboard 


for input. When SAU has finished its internal initialization, the ALPHA and READY lights are illumi- 
nated. 


All functions and parameters must be entered with no leading or trailing spaces, and must be termi- 
nated with the OCK1 key. The RESET key clears all keyboard input since the last OCK key. 


SAU from a Terminal 


If the system does not have a console, SAU looks for a Data Comm Power Pak on channel 5. SAU 
tries to establish a data comm link with a suitably configured terminal (see Terminal Configuration 
for SAU). When the data comm link is made, the ALPHA and READY lights on the MTR keyboard 
are illuminated. They remain illuminated until the user either issues a ‘‘PO”’ or a ‘“WS’’ command. 


When SAU is running from a terminal, it scrolls from the bottom of the screen. 


All functions and parameters must be entered in the top left hand corner of the screen, with no leading 
or trailing spaces, and must be transmitted using the XMT key. 


The operation of SAU on a terminal! is similar to operation on a console printer, except that on a 
terminal the XMT key is used to perform the function of the OCKI1 key of the console keyboard. 


SAU Header Message 


STAND-ALONE UTILITY 

VERSION n.n.n yyddd 

REQUEST ‘‘HELP’’ FOR FUNCTION SUMMARY 
FUNCTION 
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sata 6 ei eg eee ee Se Se 


NOTE 
“REQUEST ‘‘HELP”’ FOR FUNCTION SUMMARY” appears on status 
line of terminals. 


SAU Functions 


1. IN Initialize a disk and place the B 90 Warmstart Bootstrap on track zero. 

2. RF Reformat a disk to initial state and place the B 90 Warmstart Bootstrap 
on track zero. 

3. LD Load files to disk from cassette. 

4, COPY Copy files from disk to disk. 

5. RM Remove disk files. 

6. LS List the file names and their sizes (in sectors) of files resident on a disk. 

7. RL Relabel a disk. 

8. OL List the status of all drives on the system. 

9. WS ee the system and load the Warmstart Bootstrap (PKs 3 through 6 
it). 

10. FE Initialize a disk for MTR use (for Customer Service Engineers’ use). 

11. PO To return io the initial state (PK! and PK2 lit). 

12. CH Change the file-name of a disk file. 

13. CLEAN Clean the read/write heads of a BSMD drive. 

14. COMPARE To compare disk files. 

15. PDX Display hexadecimal dump of a disk directory or any sector on the disk. 

16. DISCOPY Duplicate a BSMII disk. 

17. Cl Initialize a disk and place the B 90 Coldstart Bootstrap in track zero. For 


use with the B 90 Coldstarting procedures. 


The syntax and a complete description of each of the functions is contained later in this section. 
NOTE 


Only one function can be run at any one time. When operating SAU, only 
input parameters may be entered or a function when SAU requests it 


Terminal Configuration for SAU 


If SAU is to be run from a terminal, a TD 830 device or equivalent (MT 983) must be installed on 
channel 5 using Burroughs Two Wire Direct Interface (TDI) and poll/select line discipline. The line 
speed configuration may be one of: 


4800 bits per second 
9600 bits per second 
19200 bits per second 
38400 bits per second 


The required TD 830 system registers for use with SAU are as follows: 
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0080 OA nn 0A 00 17 4F IF 1E 
10 3x 3y 04 nn 00 04 04 
0090 04 2F 4C 17 4F FF 20 47 
17 40 00 08 03 50 OF FF 
00A0 00 


NOTE 
X, y must lie in the range 0-9. These refer to the terminal address. 


nn refers to the line-speed register code. The codes relating to particular line- 
speeds can be found in the relevant TD 830 or MT 983 documentation. 


The required MT 983 system registers for use with SAU are as follows: 


0080 OA Al 0A 00 17 4F 1F 1E 
10 30 31 04 08 00 04 04 
0090 04 2F 4C 17 OF 00 20 47 
17 00 00 08 00 00 07 80 
00A0 00 


NOTE 
MT 983 firmware levels 3.0 and above require byte 8D to be set for language 
option. Refer to MT 983 documentation. 


Common SAU Output Messages 


Message 
FUNCTION ABORTED 


Possible Causes Suggested Action 


Hardware error. If this message is preceded by 
another message then follow that 
message, else notify customer 


service engineer. 


Dxy DEVICE ERROR 
DRIVE INOPERABLE 


Dxy DEVICE ERROR OFF 
CYLINDER 


Dxy DEVICE ERROR 
WRITE INHIBITED 


Dxy DEVICE ERROR SEEK 
TIMEOUT 


Dxy DEVICE ERROR 
CONTROLLER PROBLEM 


FUNCTION 


Specified drive was 
accidentally made Not Ready; 
or drive unit malfunction. 


Drive unit malfunction. 


Disk in specified drive has its 
write lockout indicator set. 


Drive unit malfunction. 
Drive unit malfunction. 


Prompt to request operator to 
enter next desired function. 


Ready drive; or notify customer 
service engineer. 


Notify customer service engineer. 


Ensure that the Write Lockout 
Hole (BSMD) is covered, or for 
cartridge — the Write Lockout 
Plug is flush with surface of 
cartridge. 


Notify customer service engineer. 
Notify customer service engineer. 


Enter next function, or 
“‘HELP”’ to display list of 
functions. 


Note: 


x identifies type of disk 
(M = BSMD or BSMDII, F = FIXED, K = CARTRIDGE) 


y identifies unit 
(A, B, C etc.) 
Disk 1/O Errors During SAU 


These errors are identified by the messages: 


WRITE ERROR, 

READ ERROR, 

<unit> DIRECTORY I/O ERROR 
<unit> DEVICE ERROR 


which may be encountered while running the Stand-Alone Utilities. 


Disk I/O errors indicate a failure to read from (READ error) or write to (WRITE error) disk. Such 
problems should not be allowed to persist on a disk which is to be used to store important information, 
especially where the disk is to be used as a systems disk. Therefore an explanation or fix is required 
before the drive and disk can be considered acceptable for live use. Even if the Stand-Alone Utility 
continues to run satisfactorily, there may be some form of disk corruption. After any of these errors, 
the media involved should be checked for any corruption which might cause future system problems 
(for example, the CHECK.DISK, KA or DA utilities under MCP control). 


A Note On Dual Pack Files 


A “dual pack file’ is a file which resides on two separate disks or logically identified disks (for exam- 
ple, DFA and DFB). 


A dual pack file consists of: 

A disk file header on each of the two disks. 

At least one and at most sixteen file areas, each of which may be allocated on either disk. 
Both parts have the same file name. 
Under MCP control, the file may be opened only if both parts are present. 


Each file header contains a reference (the pack-id) to the other disk. 


Therefore, if for any reason one part of the dual pack file is lost, or if the pack-id of one of the 
disk volumes is changed, the file will be inaccessible under MCP control. 


Caution must therefore be exercised when using SAU to initialize, reformat, or relabel any disk con- 
taining part of a dual pack file. Dual pack files may be located with the LS function. 


In addition to the filename and area occupied, the LS function will give, for each dual pack file, the 
overflow pack-id and the total overflow area. 


If one part of a dual pack file is lost for any reason, the SAU RM function may be used to remove 
the remaining part. 
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The terms “‘master file’? and ‘‘overflow file’? are sometimes used to distinguish the two parts of a dual 
pack file. It should be remembered, however, that either part of the file may be regarded as the master 
file. In this section the term ‘‘master’’ file is used to indicate the part of the file mentioned in a COPY 
or RM command. 


It is necessary that both ‘‘master’’ and “‘overflow”’ files reside on disks with the same allocation unit 
in order to copy them. 


The 3.05 release will not allow the creation of new dual-pack files. Any access of an existing dual- 
pack file will result in a warning message. 


CH (Change disk file name) 


This function allows the operator to change the name of disk files. 


Format: 


[— < file-name > 


CH 


Examples: 


<disk-name > / =I tle TO —= < disk-name > / = 
< group-name > < group-name > 


To change a file AR030 on a disk ARDISK to PRO30X: 


CH ARDISK/AR030 TO ARDISK/PRO30X 


< file-name > 
[ e-name =a 


: 


To change a group of files starting with GL on a disk GLDISK to a group starting with AP: 


CH GLDISK/GL= TO GLDISK/AP = 


Output Messages 


filename CHANGED TO 
file-name 


filename NOT CHANGED 
ILLEGAL FILE-ID 


filename NOT CHANGED 
WRITE LENGTH 
OVERFLOW 


filename NOT CHANGED 
WRITE LENGTH 
UNDERFLOW 


DUPLICATE FILE file-name 


filename NOT FOUND — 
filename NOT CHANGED 
INCOMPLETE DUAL PACK 
FILE 


PACK disk-name NOT ON 
LINE — file-name NOT 
CHANGED —- 
INCOMPLETE DUAL PACK 
FILE 
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Possible Canse 


Function successful. 


filename or group-name 
contains an illegal character. 


The resulting file-name is 
longer than 12 characters 
(possibly during a group 
change). 


When changing a group-name 
to a smaller group-name, the 

resulting file has no characters 
(for example, changing F= to 
= when a file called ‘‘F’’ is 

present). 


An attempt was made to 
change a file to the name of 
an already-existing file. 


The file is a dual-pack file 
and the overflow pack is 
mounted but the file is not 
present. 


The file is a dual pack file 
but the overflow pack is not 
present. 


Suggested Action 
None. 


Check input and re-enter. 


Check the group-name and re- 
input. 


Correct the group-name and re- 
input if necessary; or enter 
another CH for the file not 
changed. 


Correct the input and re-enter. 


Investigate why the other part 
of the file is missing. 


Make the overflow pack present 
and re-input. 
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(continued) 

Message Possible Cause Suggested Action 
filename NOT CHANGED An attempt was made to Correct the input and re-enter. 
DUPLICATE FILE ON change the name of a dual- 

OVERFLOW PACK pack file to the name of a 


file already present on the 
overflow pack. 


Pradennachgit, oo we ne Tor te eS 


Ci (Initialize a Disk with Coidstart Bootstrap) 


The CI function only initializes mini disks (1 MB BSMD, 3 MB BSMIi). 


The CI function initializes mini disks for use with COLDSTARTing a system (see ROM Scanning Algo- 
rithm for level 5 ROMs and COLDSTART utility). 


The CI function performs this disk 
checks the recording surface of the di 
Any “‘bad sectors’”’ (unusable or unreadable) are r 
number of bad sectors is displayed to allow bad 


The function also writes a disk label containing inf 
prompts (see Output Messages), 
number of files specified, plus a single, 
with the Coldstart Bootstrap from a file called 


and creates a dis 


or the first file on any cassette labelled ‘“‘SYSB90’’. 


The ‘‘xxxxx’’ characters are ignored by the utility; 
the on-line disks are searched (that is, 


CMSBOOT =). 


Syntax: 


Output Messages 
Message 


DRIVE <3 CHARACTERS 
OR NULL> 


DATE <MM/DD/YY> 


FILES <NUMBER LESS 
THAN 2805 > 


SERIAL <6 DIGITS> 


PACK <UP TO 7 LEGAL 
CHARACTERS > 


OWNER <UP TO 14 
CHARACTERS > 


BOOTSTRAP VERSION 
n.nn.nn USED END CI 
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Possible Causes 


Prompt looking for drive 
containing disk to be 
initialized. 


Prompt looking for the date 
of initialization. 


Prompt looking for maximum 
number of files for this disk. 


Prompt looking for disk serial 
number. 


Prompt looking for name to 
be given to disk. 


Prompt looking for user- 
defined information. 


CI End of Job. 


initialization. When all disk parameters have been requested, Cl 
sk by writing and reading test patterns to each sector of the disk. 
emoved from the disk’s available area table, and the 
ly worn disks to be discarded. 


ormation supplied by the operator to the appropriate 
k directory of the appropriate size required for the 
SYSMEM, entry. Sectors 1 through 31 on track zero are loaded 
“CMSBOOTxxxxx”’ which can be on any on-line disk 


only the first seven characters are compared when 
the file specifications searched for are equivalent to 


Suggested Action 


Enter Drive mnemonic 

or 

Enter null to terminate CI 
function. 


Enter date (format MM/DD/ 
YY). 


Enter maximum number of files 
this disk will contain (less than 
2805). 


Enter serial number (6 
numerals). 


Enter disk-name (up to 7 legal 
characters). Legal characters 
include 0-9, A-Z, . (dot), — 
(dash). 


Enter valid information (up to 
14 characters). 


None. 


eee 


Message 


NO OF BAD SECTORS 
number 


TRACK 0 BAD 


CMSBOOT NOT PRESENT 
LOAD CMS BOOTSTRAP 
AND HIT OCK/XMT TO 
CONTINUE 


i/O FAILURE — 
BOOTSTRAP NOT COPIED 


NO OF BAD SECTORS 
EXCEEDS 50 


NO COLDSTART 
BOOTSTRAP IN CMSBOOT, 
LOAD CORRECT FILE 
AND HIT OCK/XMT TO 
CONTINUE. 
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(continued) 
Possible Causes 


Disk was successfully 
initialized. If any bad sectors 
were detected, the number is 
displayed. 


Sector(s) in Track zero are 
bad and cannot be used. CI 
will end, as a CMS disk must 
contain reserved information 
in Track 0. 


System failed to find the file 
*“CMSBOOT xxxxx’’. 


A hardware error has 
occurred. 


This disk is unusable. 


The first file found called 
CMSBOOT did not contain 
the COLDSTART bootstrap. 


Suggested Action 
None. 


Select another disk to be 
initialized with CI. 


Load another drive with a disk 
containing CMSBOOT or load a 
cassette with the name 
*““SYSB90”’ containing 
CMSBOOT. Then press OCK1 
or XMT. System will re-attempt 
search for CMSBOOT. 


Place disk with CMSBOOT into 
another drive and try CI again. 
Select another disk to be 
initialized. 

Load a disk which has a 
CMSBOOT level 3.04 or greater. 
Also check that no other file 


called CMSBOOTxxxxx is 
present on the system. 


CLEAN (Clean BSM Drive Read/Write Heads) 


The read/write heads of the one megabyte mini drive are cleaned by this function. This cannot be used 
on any other type of drive. Each head is cleaned in turn by the Burroughs head cleaning diskette. 


The procedure the system follows to clean one head is as follows: 


1, Load head onto cleaning surface. 

2. Sequentially access the disk from the outermost track to the innermost. 
3. Sweep heads from the outer to the inner track and back, ten times. 
4 


. Unload head. 


The current position of the head on the disk is visually displayed by illuminated PK lights. 


Example: 
CLEAN 


Output Messages 
Message 


DRIVE 


LOAD WRITE INHIBITED 
CLEANING DISK AND 
TRANSMIT “OK”? TO 
CONTINUE 


HEAD 1 CLEANED. FLIP 
WRITE INHIBITED 
CLEANING DISK AND 
TRANSMIT ‘OK’? TO 
CONTINUE. 


HEAD 0 CLEANED END 
CLEAN 


Possible Causes 


Prompt requesting operator to 


insert cleaning disk into 
proper drive. 


Cleaning disk was inserted 
into drive. 


Head 1 has been cleaned. 


Both heads have been 
cleaned. Function ends. 
Remove cleaning disk and 
store. 


Suggested Action 


Place cleaning disk into proper 
drive. Make certain disk is write 
inhibited (write inhibit hole is 
open and is positioned at top 
corner of disk). 


Enter ‘‘OK’’ plus OCK1 to start 
cleaning procedure; or press 
OCK1 to terminate the function. 


Turn disk upside down (write 
inhibit hole to bottom) so that 
cleaning surface faces other side; 
then enter ‘‘OK’’ and press 
OCK1 to begin cleaning 
functions. 


Any attempt to clean head 0 before head 1 will result in the ““LOAD/FLIPDISK’’ message being 


prompted. 


WARNING 


Any attempt to use a write-enabled disk or any disk other than the cleaning 
disk during execution of this function will result in serious damage to the disk 


drive. 


2032801 


8-21 


COMPARE (Compare two disk files) 


This function allows the operator to compare files present on disk. 


Format: 


< file-name > 
COMPARE —— < disk name > / 4 fan — <disk-name > 
< group-name > 


Examples: 


< file-name > ge 


< group-name > — 


To compare a file PR200 on disk PRDISK with another file PR200 on disk USER: 


COMPARE PRDISK/PR200 WITH USER/PR200 


To compare a group of files starting with IN on the disk INDISK with a group of files starting wit? 


XY on the disk XYZ: 


COMPARE INDISK/IN= WITH XYZ/XY= 


Before the files are compared, a check is made that the file sizes and number of areas are consister*. 


If any conflicts are found here, the function will be terminated. 


Output Messages 
Message 


filename NOT FOUND 


FILE SIZE CONFLICTS — 
END COMPARE 


CONFLICTIONS IN 
NUMBER OF AREAS — 
END COMPARE 


disk-name/file-name 
COMPARED WITH disk- 
name/file-name — NO 
CONFLICTS FOUND 


disk-name/file-name 
COMPARED WITH disk- 
name/file — CONFLICTS 
FOUND 


PACK disk-name NOT ON 
LINE — file-name NOT 
COMPARED - 
INCOMPLETE DUAL PACK 
FILE 


filename NOT FOUND file- 
name NOT COMPARED 
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Possible Cause 
Self-explanatory. 


One file contains more 
records than the other. 


The number of areas assigned 
to the two files are different. 


Successful file comparison. 


The compare was 
unsuccessful. 


Comparison of dual pack file 
was required and the overflow 
pack was not on line. 


Comparison of dual pack file 
was required and the overflow 


Suggested Action 
Check input. 
None. 


None. 


None. 


Check SPO and error logs for 
any errors during copying of 
either file; re-copy file(s) from 
backup disks and re-run the 
COMPARE function. 


Make the overflow pack present 
and re-input COMPARE 
function. 


Investigate why the file was not 
present on the overflow pack. 


Message 


(continued) 
Possible Cause 


INCOMPLETE DUAL PACK pack was present but did not 


FILE 
END COMPARE 
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contain the required file. 


End-of-job of this SAU None. 


function. 


Suggested Action 
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COPY (Copy files disk to disk) 


This function allows the operator to copy files from one disk to another. Overflow files will not be 


copied. 


COPY —— < disk-name > / 


Examples: 
To copy a single file: 
COPY PR1/PR200 TO PRBU/PR200 
To copy a group of files: 
COPY PR1/PR= TO PRBU/PR= 
To copy all files on one disk to another: 
COPY PR1/= TO PRBU/= 
To copy a file and change its name: 
COPY PR1/PR200 TO PRBU/PR200B 


Output Messages 
Message 


DUPLICATE FILE NAME 


Possible Causes 


System detected a file name 
on disk identical to that 
which the operator is 
attempting to copy. No two 
files with the same name may 
reside on a disk. Therefore 
specified file was not copied. 


NAME LIST FULL When this disk was initialized, 
the disk directory was 
constructed to contain a fixed 
number of file names. The 
directory has now reached its 


capacity. 


Dxy DIRECTORY 1/0 
ERROR 


A read or write error was 
encountered while the system 
was attempting to access the 
directory of the specified disk. 
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< file-name > 
+ TO ——— <disk-name > / 
< group-name > 


< file-name > 


< group-name > 


Suggested Action 


Normally, remove the existing 
file with RM; reattempt the 
COPY. Check input for correct 
specification of file names. 


The COPY function ends 
automatically. If possible, 
remove with RM any unwanted 
file(s) to make room in the disk 
directory. Then re-attempt to 
COPY the file which 
encountered the error; 

Replace the disk with a disk 
that has sufficient room in the 
disk directory. 


1. Change the position of the 
disks and retry. 

2. For a group copy, some files 
may be recovered using single 


A 


Message 


WRITE DISK IS NOT 
WRITE PERMIT 


filename NOT FOUND 


PACK disk-name NOT ON 
LINE 


INVALID REQUEST 
END COPY 


file-name COPIED 


CANNOT ALLOCATE 
AREAS FOR — file-name 


filename NOT CHANGED 
— O/P LENGTH 
OVERFLOW 


filename NOT CHANGED 
— O/P LENGTH 
UNDERFLOW 


O/P ERROR — file-name 


READ ERROR -— file-name 


filename NOT COPIED: 
ILLEGAL FILE-ID 
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(continued) 
Possible Causes 


The directory structure of the 
input (source) disk may be 
corrupted. 


Destination disk (disk to 
which system is copying) is 
write inhibited. 


Specified file-name is not on 
disk. 


Specified disk is not on-line 
to the computer. 


Typing error. 


Copy successful (OJ); 
Specified group name to be 
copied is not on disk. 


COPY successful. 


Insufficient available space on 
disk to which operator is 
attempting to copy this file. 


The resulting file-name is 
longer than 12 characters. 


The resulting filename has no 
characters. 


Error encountered while 
system was attempting to 
write specified file to disk. 


System encountered errors in 
the file from which it was 
reading. 


Specified file-name contains 
an illegal character (that is, 
/ ?), therefore file will not be 


Suggested Action 
file copy. 
If these attempts fail, then type 
of error should be analyzed with 
DA utility and disk re-initialized 
before re-use. 


For cartridges: ascertain that 
write lockout plug is flush with 
outer surface of cartridge; 

For BSMD: ascertain that the 
write lockout hole is covered; 
Retry the COPY. 


Check input — re-enter if 
necessary; 
Check for correct disk. 


Check input — re-enter if 
necessary; 
Check for correct disk. 


Check input and re-enter. 


None if copy successful; 
Check input — re-enter if 
necessary; 

Check for correct disk. 


None. 


Using KA utility, analyze disk 
available space. 


Correct the group name and re- 
input. 


Correct the group name and re- 
input if necessary. 


Allow COPY to continue 
copying any remaining files. 
Then re-attempt copying the file 
in which the O/P error 
occurred. 


Allow COPY to continue. Then 
use back-up copy of the 
specified file and re-attempt the 
COPY; switch the disks to the 
opposite drives. 


Check input and re-enter if 
necessary. 


(continued) 
Message Possible Causes Suggested Action 

copied. Legal characters are 
0-9, A-Z, . (dot), — (dash). 

filename COPIED: Disk-to-disk copy is being 

ILLEGAL FILE-ID made and this warning is 
given that the new file is 
copied but with an invalid 
file-name. 


Dual Pack Files 


The copy function cannot create a dual pack file, however a complete dual pack file may be copied 
to a single disk. 


The master file will be copied first. COPY will then look for a matching overflow file on the overflow 
pack. If a matching overflow file is found, it will be copied and the function will terminate with the 
message: 

filename COPIED FROM disk-name-1 AND disk-name-2 


If the overflow pack is not on line, or the overflow file is not found, or an overflow file is found 
which does not match the master file, the function will print the following message, and wait for 
operator input: 


disk-name-fileename IS AN INCOMPLETE DUAL PACK FILE 

A MATCHING OVERFLOW FILE ON disk-name-2 IS NOT PRESENT. 

PLEASE TAKE ONE OF THE FOLLOWING ACTIONS: 
A. SUPPLY THE CORRECT OVERFLOW PACK AND TYPE “A” TO TRY AGAIN. 
B. TYPE ‘‘B’’ TO SKIP THIS FILE. 


At this stage the master file pack may be removed if necessary. 


The operator should either power on the correct overflow pack and type ‘‘A”’ followed by OCK1 or 
type ‘‘B’’ followed by OCK1. 


If the ‘‘A”’ option is selected, the function will repeat its search for the overflow file as above and 
either terminate normally or repeat the prompt to the operator. 


If option ‘‘B’’ is selected, the output file will be purged and the function will terminate with the mes- 
sage: 


filename NOT COPIED, PART OF A DUAL PACK FILE 


WARNING 
If a level of SAU earlier than 3.00 is used to copy a dual pack file or a fam- 
ily containing a dual pack file, the output disk is liable to be seriously cor- 
rupted and to require re-initializing. 
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av ents 


DISCOPY (Duplicate a BSMI! Disk) 


This function allows the operator to copy the contents of a Burroughs Super Minidisk I] (BSMDII) 


to another BSMDII. 


Format: 


All information is copied from one BSMII to another, that is, disk label, bootstrap, directories and 
data. Thus a complete disk can be duplicated for backup purposes without initialization. The automatic 
relocation of bad sectors allows the duplicated directories to remain valid since all information on the 
duplicated disk will have the same logical, if not physical, address as that on the master disk. 


Output Messages 
Message 


END DISCOPY 


NON BSMII DISK 
SPECIFIED 


PACK <up to 7 iegai 
characters > 


drive-mnemonic PURGED 


FUNCTION ABORTED —- 
drive-mnemonic NOT 
PURGED 


drive-mnemonic COPIED TO 
drive-mnemonic 
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Possible Cause 
End of function. 


Either of the disks specified is 
not a BSMII disk. 


This is a prompt for the 
operator to give the seven 
character disk-name of the 


input disk. 


An input error has occurred 
during the copy. The output 
disk is purged by overwriting 
track zero with ‘‘null’’ 
characters. 


An I/O error has occurred on 
the output drive during the 
copy, and the copy is 
stopped. 


Function successful. 


Suggested Action 
None. 


This function can only be 
performed on BSMII disks: use 
COPY for other kinds of disk, 
including BSM (1MB) disk. 


Investigate cause of error on the 
input disk, then re-run the 
DISCOPY function: the purged 
output disk may be re-used. 


Use the LS function to 
determine which files are 
successfully copied to the output 
disk: these may be recovered. 
Otherwise re-run the DISCOPY 
function using a different output 
disk. 


None. 
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FE (Initialize MTR Disk) 


A virgin or formatted disk is initialized to CMS format with suitable sectors reserved for Maintenance 
Test Routines (MTRs). These sectors are denoted as bad sectors on a KA map of the disk. The surface 
is checked by writing and reading patterns to each sector. Bad sectors and MTR tracks are made 
unavailable. A disk label is written and the file directory is created with a single, SYSMEM, entry. 
Sectors 1 through 31 on track zero are loaded with the relevant MTR Bootstrap from a file called 
““CMSBOOTxxxxx”’ which can be on any on-line disk or the first file on any cassette labelled 
“SYSB90”’. 


The ‘‘xxxxx’’ characters are ignored by the utility; only the first seven characters are compared when 
the on-line disks are searched (that is, the file specifications searched for are equivalent to 
CMSBOOT =). 


In the case of a fixed disk, the CMS Bootstrap (Warmstart Bootstrap) is loaded from CMSBOO- 
Txxxxx. When all other disks are initialized, FE loads the relevant MTR Bootstrap from CMSBOO- 


i i - Ain aay 18 L et, PRC eae RAIN Ga 
The MTR tracks are not included in the number of cctors, but if the disk is reformatted (see 


had o« 
RF), the total number of sectors (including those on MTR tracks) removed from the available table 
will be referred to as bad. 


Syntax: 
a 


Output Messages 


Message Possible Causes Suggested Action 
DRIVE <3 CHARACTERS Prompt looking for drive Enter Drive mnemonic 
OR NULL> containing disk to be or 
initialized. Enter null to terminate FE 
function. 
DATE <MM/DD/YY> Prompt looking for the date Enter date (format MM/DD/ 
of initialization. YY). 
FILES <NUMBER LESS Prompt looking for maximum Enter maximum number of files 
THAN 2805> number of files for this disk. this disk will contain (less than 
2805). 
SERIAL <6 DIGITS> Prompt looking for disk serial Enter serial number (6 
number. numerals). 
PACK <UP TO 7 LEGAL Prompt looking for name to Enter disk-name (up to 7 legal 
CHARACTERS > be given to disk. characters). Legal characters 
include 0-9, A-Z, . (dot), — 
(dash). 
OWNER <UP TO 14 Prompt looking for user- Enter valid information (up to 
CHARACTERS > defined information. 14 characters). 
BOOTSTRAP VERSION FE End of Job. None. 


n.nn.nn USED END FE 
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Message 


NO OF BAD SECTORS 
number 


TRACK 0 BAD 


CMSBOOT NOT PRESENT 
LOAD CMS BOOTSTRAP 
AND HIT OCK/XMT TO 
CONTINUE 


BAD MTR TRACK 


CYL xxx BAD 


1/O FAILURE — 
BOOTSTRAP NOT COPIED 


NO OF BAD SECTORS 
EXCEEDS 50 
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(continued) 
Possible Causes 


Disk was successfully 
initialized. If any bad sectors 
were detected, the number is 
displayed. 


Sector(s) in Track zero are 
bad and cannot be used. FE 


‘will end, as a CMS disk must 


contain reserved information 
in Track 0. 


System failed to find the file 
““CMSBOOT xxxxx’’. 


An MTR track contains a 
bad sector. 


In cases where certain 
evlinders are used for MTR 
purposes but are not removed 
from the available table, 
discovery of a bad sector will 


terminate the function. 


A hardware error has 
occurred. 


This disk is unusable. 


Suggested Action 
None. 


Select another disk to be 
initialized with FE. 


Load another drive with a disk 
containing CMSBOOT or load a 
cassette with the name 
“SYSB90”’ containing 
CMSBOOT. Then press OCK1 
or XMT. System will re-attempt 
search for CMSBOOT. 


Select another disk to be 
initialized with FE. 


Select another disk to be 
initialized by FE. 


Place disk with CMSBOOT into 
another drive and try FE again. 


Select another disk to be 
initialized. 
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IN (Initialize a Disk with Warmstart Bootstrap) 


The Master Control Program (MCP) requires that any disk to be used on the system has a valid CMS 
disk label, disk directory, available area table, and a valid Bootstrap code in track zero. In addition, 
each sector of the disk must be initialized with its address. 


The IN function performs this disk initialization. When all disk parameters have been requested, IN 
checks the recording surface of the disk by writing and reading test patterns to each sector of the disk. 
Any “‘bad sectors’’ (unusable or unreadable) are removed from the disk’s available area table, and the 
number of bad sectors is displayed to allow badly worn disks to be discarded. 


The function also writes a disk label containing information supplied by the operator to the appropriate 
prompts (see Output Messages), and creates a disk directory of the appropriate size required for the 
number of files specified, plus a single, SYSMEM, entry. Sectors 1 through 31 on track zero are loaded 
with CMS bootstrap (Warmstart Bootstrap) from a file called ‘““CMSBOOTxxxxx’’? which can be on 
any on-line disk or the first file on any cassette labelled ‘‘SYSB90’’. 


The ‘‘xxxxx’’ characters are ignored by the utility; only the first seven characters are compared when 
the on-line disks are searched (that is, the file specifications searched for are equivalent to 
CMSBOOT =). 


Since all fixed disks must be suitable for MTR purposes, the functions IN and FE are identical in this 
particular case. The relevant MTR tracks are checked and/or removed and the CMS Bootstrap (Warm- 


start Bootstrap) is written into sectors 1 through 31 of track zero. 


Syntax: 


Output Messages 
Message 


DRIVE <3 CHARACTERS 
OR NULL> 


DATE <MM/DD/YY> 


FILES <NUMBER LESS 
THAN 2805> 


SERIAL <6 DIGITS> 


PACK <UP TO 7 LEGAL 
CHARACTERS > 


OWNER <UP TO 14 
CHARACTERS > 
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N——_—_—_—____| 


Possible Causes 


Prompt looking for drive 
containing disk to be 
initialized. 


Prompt looking for the date 


of initialization. 


Prompt looking for maximum 
number of files for this disk. 


Prompt looking for disk serial 
number. 


Prompt looking for name to 
be given to disk. 


Prompt looking for user- 
defined information. 


Suggested Action 


Enter Drive mnemonic 

or 

Enter null to terminate IN 
function. 


Enter date (format MM/DD/ 
YY). 


Enter maximum number of files 
this disk will contain (less than 
2805). 


Enter serial number (6 
numerals). 


Enter disk-name (up to 7 legal 
characters). Legal characters 
include 0-9, A-Z, . (dot), — 
(dash). 


Enter valid information (up to 
14 characters). 


Message 


BOOTSTRAP VERSION 
n.nn.nn USED END IN 


NO OF BAD SECTORS 
number 


TRACK 0 BAD 


CMSBOOT NOT PRESENT 
LOAD CMS BOOTSTRAP 

AND HIT OCK1/XMT TO 
CONTINUE 


I/O FAILURE — 


RPOOTSTRAP NOT COPIED 


Mwwwoviwve ancan iwwa 


NO OF BAD SECTORS 
EXCEEDS 50 
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(continued) 
Possible Causes 


IN End of Job. 


Disk was successfully 
initialized. If any bad sectors 
were detected, the number is 
displayed. 


Sector(s) in Track zero are 
bad and cannot be used. IN 
will end, as a CMS disk must 
contain reserved information 
in Track 0. 


System failed to find the file 
““CMSBOOT xxxxx’’. 


A hardware error has 


occurred 
2 ‘ 


Whee 


This disk is unusable. 


Suggested Action 
None. 


None. 


Select another disk to be 
initialized with IN. 


Load another drive with a disk 
containing CMSBOOT or load a 
cassette with the name 
*“SYSB90’’ containing 
CMSBOOT. Then press OCK1 
or XMT. System will re-attempt 
search for CMSBOOT. 


Place disk with CMSBOOT into 
another drive and try IN again. 


Select another disk to be 
initialized. 
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LD (Load files from cassette to disk) 


This function allows the operator to load all files from a dump tape to a disk. A dump tape is one 
produced by the DUMP or UNLOAD functions of the utility ““LD’’ (which runs under MCP control). 
Each sector of data written to disk is verified. The SAU LD function cannot create a dual pack file. 


Format: 
LD <disk-name> FROM <library-tape-name> 
Example: 


LD ARDISK2 FROM ARTAPE 


Output Messages 
Message Possible Causes Suggested Action 
filename LOADED Displayed for each file loaded None. 
and verified. 
LOAD REEL number Dump tape is a reel from a Supply next reel. 
muiti-reei dump and the next 
reel is required. 


END LD LD (EOJ) None. 
NOT DUMP TAPE Specified tape is not a Supply correctly formatted dump 
correctly formatted dump tape; re-initiate LD. 
tape. Function ends. 
multi-file-name NOT Specified tape is not installed Install and ready tape; re-initiate 
PRESENT. LOAD and ready; function ends. LD; or press OCK1 to retry 
CASSETTE AND PRESS search for multi-reel name tape; 
OCK OR ENTER NULL TO or press any key plus OCKI to 
TERMINATE terminate LD. 
IRRECOVERABLE Error was encountered while Ready cassette drive unit; re- 
CASSETTE ERROR system was attempting to read initiate LD. 


cassette. Normally caused by 
accidentally opening cassette 
drive unit. Function ends. 


PACK disk-name NOT Specified disk is not ready; Ready the disk; 
FOUND specified disk is not on-line to Check for correct disk. 
computer. 
O/P DISK NOT WRITE Disk to which files are to be Ensure that write lockout hole is 
PERMIT loaded is write protected. covered (for BSMD); 
Function ends. For cartridge, ensure write 


lockout plug is flush with 
surface of disk cartridge; 
re-initiate LD. 


DUPLICATE FILE NAME File of specified name already Remove (with RM) the existing 
— file-name exists on destination disk. A file from disk, then re-initiate 
disk may not contain two LD. 
files with the same name. LD 
continues loading other files, 
ignoring any duplicates. 
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a 


Message 


CANNOT ALLOCATE 
AREAS FOR — file-name. 


O/P ERROR — file-name 


AREA SIZES TOO SMALL 
FOR — file-name 


NAME LIST FULL 
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(continued) 
Possible Causes 


No appropriately sized 
available area on the 
destination disk for specified 
file. 


Disk write error encountered 
while system was loading 
specified file. 


Insufficient available area on 
disk for specified multi-area 
file. 


No space remaining in disk 
directory for another file 
name. Function ends. 


Suggested Action 


If specified file is desired, 
replace this disk with a disk 
having more available area. 
Then re-initiate LD. 


Place disk in opposite drive and 
re-initiate LD. 


If specified file is desired, 
replace this disk with a disk 
having more available area. 
Then re-initiate LD. 


Use another disk, or remove 
unwanted files with the RM 
function. 
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LS (List File Sizes) 


This function allows the operator to print names and sizes in sectors of files on a specified disk. For 
dual pack files, both portions of the files and their sizes are printed. If all file sizes on a disk are 
printed by: 

LS <disk-name>/= 


then all available areas of that disk are printed at the end of the list. 


Railroad diagram: 


< file-name > 
LS <disk-name > / | OH 
; < group-name > 


Example: 


To list file sizes of all the files on the disk ARDISK2 


LS ARDISK2/= 

Output Messages 

Message Possible Causes Suggested Action 
PACK disk-name NOT ON Specified disk is not on line Check input — re-enter if 
LINE to the computer. necessary; 

Check for correct disk. 

END LS LS successful (EOJ) None. 
Dxy DIRECTORY I/O A read or write error was 
ERROR encountered while the system 


was attempting to access the 
directory of the specified disk. 
The directory structure of the 
disk may be corrupted. 
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OL (Print Status of Drives) 


This function allows the operator to print the status of all cassette and disk drives. 


Example: 
OL 
Output Messages 
Message 
END OL 
disk drive disk-name 


disk drive NOT READY 


disk drive NOT CMS- 
STANDARD 


cassette drive NOT READY 


cassette drive UNLABELLED 


cassette drive multi-file-name 
file-name 

disk-drive TEMPORARILY 
NOT AVAILABLE 


Possible Causes 
OL successful (EOJ). 


Specified disk is resident in 
specified drive. 


There is no disk in this drive; 
the disk in the drive has not 
been set to run; the disk in 
the drive has not come up to 
proper speed; system does not 
recognize disk. 


Disk in this drive does not 
have a valid CMS label. 


There is no cassette in this 
drive; cassette has not been 
loaded into drive properly. 


Cassette in specified drive 
does not have a valid label. 


Cassette in this drive has the 
specified name. 


The door of the disk drive 
has been opened. 


Suggested Action 
None. 
None. 


If applicable — set disk to run; 
or allow disk to attain proper 
speed; make certain disk has a 
proper ‘‘label’’. 


Disk must be initialized with IN 
to create valid CMS label. 


Check for proper loading of 
cassette in drive. 


Use PG to create valid cassette 
label. 


None. 


Close the door. 


MTR cassettes do not have labels corresponding to the correct CMS format and thus will appear “‘UN- 


LABELLED’’. 
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PDX (Print Disk Directories) 


This function allows the operator to print the disk directories, disk label and any sector in hexadecimal. 


Format: 


PDX 


The function operates in interactive mode. The operator is prompted to supply the input. 


Output Messages 
Message 


DRIVE 
IS DIRECTORY REQUIRED 


<Y OR N> 


SECTOR <6 character hex 
value or null> 


COMPLETE <Y OR N> 


LABEL CORRUPT 


END PDX 
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Possible Cause 


This is a prompt to the 
operator. 


This is a prompt to the 
operator. 


The operator is prompted to 
provide the hex address of a 
sector to be displayed. This 
prompt is repeated until a 
null response (just an OCK 
key) is given. 


The operator is prompted to 
state if printing of all sectors 
in the disk directory is 
required or only the first 
sector of each entry. 


The check-string 
“SLOINTERNL’’ in sector 
zero has not been found. 


End of PDX function. 


Suggested Action 


Enter the device mnemonic of 
the disk to be read; for 
example, DKA. 

Enter ‘‘Y”’ if a complete 
directory print is required, 
otherwise enter ‘‘N’’. 


Enter the 6-character hex sector 
address followed by OCK1, or 
just OCK1 to terminate the 
function. 


Enter ‘‘Y”’ or ‘‘N’’ as 
appropriate. 


None: use backup copy of disk 
for normal use. 


Enter desired SAU function. 


PO (Power Off) 
This function allows the operator to terminate the execution of the Stand-Alone Utilities. 
Example: 
PO 
The utility displays the message: 
END STAND ALONE UTILITY 


and causes the B 90 to return to the initial state (PK1 and PK2 lit). 


RL (Relabel a disk) 


This function allows the operator to change a disk’s name without affecting the remaining contents 
of the disk. 


Format: 

RL <disk-name> 
Example: 

To relabel a disk called AP2 to BQ3 enter: 

RL AP2 

Then enter ‘‘BQ3’’ after the utility has displayed/printed ‘“PACK”’’ 
Output Messages 


Message Possible Causes Suggested Action 
END RL RL successful (EOJ). None. 
PACK Prompt to request operator to Enter new disk name (up to 7 

enter the new disk name. legal characters). 
PACK disk-name NOT ON Specified disk is not on line Check input — re-enter if 
LINE to the computer. necessary; 
Check for correct disk. 

Dxy DIRECTORY I/O A read or write error was 
ERROR encountered while the system 


was attempting to access the 
directory of the specified disk. 
The directory structure of the 
disk may be corrupted. 


Warning 


If RL is used on a disk containing part of a dual pack file, that file will be inaccessible under MCP 
control. 


There are two ways to prevent this from occurring: 

1. Remove the file before relabelling the disk. 

> Copy the entire file to a single pack file before relabelling. 
There are two ways to resolve the problem if it does occur: 

1. Use Stand-Alone Utility (RM) to remove the file. 


or 
2. Use Stand-Alone Utility (RL) to relabel the disk to its original name. 
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RM (Remove Disk Files) 


This function allows the operator to remove files from disk. 


[— < file-name > ——7 
RM <disk-name > / | + 


Li< group-name > — 


Examples: 
To remove a single file: 
RM PR1/PR200 
To remove a group of files: 
RM PR1/PR= 
To remove all files from disk: 
RM PRI/= 
Unlike the RM utility that runs under MCP control, the Stand-Alone RM will remove system software 


(MCPX, COBOLINTX, BILINTERPX, etc.) without a warning message, the same as it removes other 
programs. 


Output Messages 


Message Possible Causes Suggested Action 
filename REMOVED RM successful. None. 
PACK disk-name NOT ON Specified disk is not on-line Check input — re-enter if 
LINE to the computer. necessary; 
Check for correct disk. 
filename NOT FOUND Specified file-name is not on Check input — re-enter if 
disk. necessary; 
Check for correct disk. 
END RM RM successful (EOJ); None if RM successful. Check 
Specified group name to be input — re-enter if necessary. 
removed is not on disk. Check for correct disk. 


Dual Pack Files 
If a file to be removed has an overflow area or another disk volume: 
— If both parts of the file are available, both are removed and the following message is printed: 
filename REMOVED FROM disk-name-1 AND disk-name-2 


— If the overflow file is not found for any reason, or if a file is found with the same file-id 
but which does not match the master file, then the following message is printed: 
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disk-name/file-name IS AN INCOMPLETE DUAL PACK FILE 
A MATCHING OVERFLOW FILE ON disk-name-2 
IS NOT PRESENT. PLEASE TAKE ONE OF THE 
FOLLOWING ACTIONS: 

A) SUPPLY THE CORRECT OVERFLOW PACK 

AND TYPE ‘‘A” TO TRY AGAIN 
B) TYPE ‘“‘B” TO SKIP THIS FILE 
C) TYPE “‘C’”? TO REMOVE THE INCOMPLETE FILE 


If option ‘‘A’’ is selected, then either the complete file will be removed or the above prompt will be 
repeated. 


If option “‘B”’ is selected, then the following message is printed: 
filename NOT REMOVED, PART OF DUAL PACK FILE 
If option ‘‘C’’ is selected, then the following message is printed: 


filename REMOVED ONLY FROM disk-name-! 
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WS (Warm Start) 


This function causes a “‘branch” to the warmstart routine stored in the Read Only Memory (ROM) 
of the machine. It will cause the CMS operating system (filename MCPX) to be loaded from disk 
into memory. 
Operating Procedure 
Type “‘WS’” then press OCK1. Wait for PKs 3, 4, 5 and 6 to be illuminated. 
Press PK3. 
Enter today’s date in the format: 
MM/DD/YY 
when prompted to do so. 


For further information, refer to the section headed ‘‘Loading the MCP’’. 
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LOADING THE MASTER CONTROL PROGRAM (MCP) 


This process is also called the ‘‘Warmstart procedure’. 
The B 90 MCP code file is named ‘‘MCPX”? (this is its executing name). 


From the initial state (PK1 and PK2 lit), press PK2. This causes the ROM to load the Warmstart Boot- 
strap (see relevant ROM Scanning Algorithm). For errors, see Hardware Error Conditions and System 
Load Errors. 


When the Warmstart Bootstrap has been loaded and executed, PK3 through PK6 will be lit. Press PK3. 


The Bootstrap searches for a disk file called ‘““MCPX’’. The search for the MCP proceeds as outlined 
in Warmstart Bootstrap Scanning Algorithm later in this section. 


For failures in the search, see Hardware Error Conditions and System Load Errors. 


If the MCP search is successful, the MCP is loaded to memory and MCP initialization takes place. 
The activity during this process can be distinguished on the D-lights (bank 5). 


NOTE 
The references to banks are for consoleless systems. 


When the initial part of the MCP is loaded, the D2 (bank 5 PK2) light flickers. 
Any printers on the system are initialized. 


Automatic Volume Recognition (AVR) (see Jater in this section) is performed on all peripherals. During 
AVR, D2 flickers, with D4 through D8 lit (bank 5 PK2 flickers with PK4 through PK8 lit). 


The MCP communicates to the operator via the SPO. The SPO device can be the console, SELF-SCAN 
or terminal, according to data in the SYSCONFIG file. The following describe the differences between 
the different SPO devices. 


NOTE 
The version of the MCP is identified by mark/level/patch numbers. For ex- 
ample, version 3.04.09 is mark 3, level 3.04, patch 3.04.09. A new software 
release is denoted by a higher level number (for example, 3.05). Within a re- 
lease, higher patch numbers indicate improved versions of that level. For ex- 
ample, the application of two patches to 3.04.22 will create an MCP version 
3.04.24 (see PATCHMAKER for details of how to patch MCP files). 


Console and SELF-SCAN SPO Device 


The system prints the MCP version on the SPO device, followed by a list of on-line peripherals that 
are powered up. 


The system requests the date. Press the Ready Request button and verify that the ON, READY and 
ALPHA lights are lit. Enter the date as requested (mm/dd/yy), followed by OCK1 (leading zeros are 
optional). The system prints a date message. 

The MCP automatically loads the program SYS-SUPERUTL (D2, D3, D4, DS and D7 lit). 

The message ‘“COMMENCING LOG FILE CONSOLIDATION” is displayed as SYS-SUPERUTL zips 


the TL utility. For a full explanation of logging, refer to Logging in the 3.04 Release in Section 4 
of this manual. 
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Optionally, depending on SYSCONFIG, a user program is loaded and executed. 
The warmstart is complete and the MCP enters idle state (see below). 
It is inadvisable to enter system commands until the complete warmstart procedure is over, otherwise 


confusion can result. Also, such input is not entered in the system log (if system message logging is 
declared in SYSCONFIG). 


Example: 
* * * * * * * * * * * ¥ 
« COMPUTER MANAGEMENT x, 
» SYSTEM (CMS) 83328 
MCP VERSION 03.05.08 
x * * * ££ & K & * F 
DFA SYSTEMS/ SYS DISK 2 FILES OPEN 
ENTER DATE AND TIME AS “MM/DD/YY HHMM” 
6/18/84 


18 JUN 84 84170 MON 1113 

COMMENCING TRANSFER OF OLD LOG FILES 
LOG INFORMATION TRANSFERRED 

END TL 

COMMENCING CREATION OF NEW LOG FILES 


LOGGING IS INITIATED ON 06/18/84 AT 11:25:48 (MCP VERSION 03°05 508) 


For possible errors, see System Load Errors later in this section. 
Terminal SPO Device 


The MCP performs the same functions as described previously in Console and SELF-SCAN SPO De- 
vice, except that it cannot request a date to be input, as at this point there is no SPO device. 


By entering CTL ON on one of the terminals, this terminal becomes controlling SPO. 
By pressing the SPCFY key the user may move from the SPO page to the application page. 


All other terminals with TD 830 capabilities may be non-control SPO at the same time. To obtain this 
function, depress the SPCFY key. 
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BASIC OPERATION UNDER MCP CONTROL 


D-Lights (Bank 5) 


During MCP execution, D-lights D1 to D8 give an indication of system activity, as shown in figure 
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Mix 
BAILIFF 00 
Long wait —————— 0 X —— X —— X—— X—— X PROGRAM 01-— 25 
Short Wait ———__L__ 0 X meee Nae KK a X UTILITY O1— 25 
Swapped out 0 —— 0 0o—-0 ———_——- 0 SYS-SUPERUTL 26 
Normal priority 0 0o—0 —————- 9 —— 0 ———__SPIM 27 
Om 0S CS 28 
o—0 — 0 ———— 9) NDL 29 
o—0o—0——0 Program Loader 30 
0o——0 ——-0 —— 0 ——-0 AVR 31 
< current > < mix number executing >. 
< operating > 
< state > 
Figure 8-4. D-Light Display Interpretation 
The light combination at any instant denotes the current function and state of that function. “0”? de- 


notes the light is ON and ‘‘x’’ denotes ‘‘DON’T CARE’. 


NOTE 


The following tasks are not shown in the response to the MX intrinsic BAI- 
LIFF, Program Loader and AVR. Also, SYS-SUPERUTL is not shown in 
the response to the MX intrinsic unless a particular function is being per- 
formed. In this case, the MX response shows the name of the function, for 


example, 26/RM or 26/PD. 


MCP States 


‘ 


When warmstart is complete, the MCP is either idle or executing a task. The idle state is identifiable 
by the absence of activity on the D-lights. In this state, three distinct patterns can be encountered: 


D2, D3 only lit: 


The last activity was a program which has gone to EOJ. 


D1, D3, D4, DS, D7 only lit: 


The last activity was a SYS-SUPERUTL function (IR, LB, LF, PD, RM, KX or CH). 


D1, D3, D4, D5, D6, D7 only lit: 


The last activity was a system intrinsic. 
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When the MCP is executing a task, the mix number is evident in D-lights D4 through D8 (see D-light 
display). 


At any time when the system is idle (that is, when the mix is empty except for SPIM, MCS and NDL) 
it is valid to terminate the MCP by a PO of the system disk (see PO intrinsic). 


Automatic Volume Recognition (AVR) 


This procedure is carried out if any new media is loaded onto the system. If the procedure fails, the 
device is made not ready. The procedure varies for different media. 


For fixed disk, disk cartridge, Burroughs Super Mini (BSM) disk, Burroughs Super Mini II disk and 
ICMD, AVR attempts to read the labei. 


For cassette, AVR searches for a CMS label or scratch label, otherwise the cassette is treated as unla- 
belled. 


In all cases, if transient errors are suspected, Readying the peripheral (see RY intrinsic) re-initiates the 
AVR process. 


Console Keyboard Under MCP Control 


Under MCP control, the console keyboard may be used to enter system commands to the MCP, or 
solicited data to 2 program. Commands to the WMCe aay oily be entered “when the READY light is 
lit. Data to a program may only be entered on the alpha keyboard if the ALPHA light, but not the 
READY light, is lit. Input is terminated by an OCK key, or a PK key only if the corresponding PK 
light is lit. It can be seen that the keyboard can exist in one of three states: inactive, system enabled, 
or program enabled. 


Since an understanding of the operation and behaviour of the keyboard and its indicators is essential, 
some important points are noted here. 


If a disabled key is pressed at any time, or too much data is entered at once, then an error bell rings 
and the ERROR indicator lights. This error condition must be reset before any further keyboard input 
can be made. 


The RESET key has two basic functions, resetting the error condition explained above, or clearing the 
information keyed since an OCK or PK key was last pressed. This key is necessarily enabled whenever 
any alpha or numeric key is enabled. 


When some incomplete information has been keyed either to the MCP or a program, then it is neces- 
sary to terminate some information to this destination before entry to the other destination can be al- 
lowed. For example, once the READY light is lit an OCK key must be pressed to terminate input to 
the MCP before any input can be keyed to a waiting program. This restriction stands even if the RE- 
SET key is used. 


If the keyboard is enabled for input, then the D-lights are not lit. 


In order to enable keyboard input to the MCP, the READY ENABLE key must be pressed. This key 
is ignored if the SCL/LOADER routine of the MCP is currently executing a system command or load- 
ing a program (D4, D5, D6, D7 lit) and a wait of up to 30 seconds may be necessary before any key- 
board input can be made. Similarly, if the MCP is very busy when a request for input is made, there 
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may be a delay of one or two seconds before the keyboard becomes enabled for input. A maximum 
of two characters can be entered in this time, or a keyboard error condition will arise. 


If the system is being used with the self-scan screen operating as a SPO device as well as a console 
file, then the READY ENABLE key has an additional function. This key must be depressed in order 
to prompt the MCP to display either the complete screenful of messages on the screen, or the last 
message on the bottom line of the screen (scrolling the other information up one line). When the screen 
is being used as a console file, the screen displays information from the program using it until the 
READY ENABLE key is pressed. 


If the screen is displaying SPO information, pressing an OCK returns the display to the console file 
information. 


Interrupting the MCP 


It is possible to interrupt the MCP while it is running. This informs the MCP that some action must 
be taken. The ability to interrupt the MCP is a good indication that the system is running satisfactorily. 
The only conditions where it may prove impossible to cause an interrupt is when the MCP is processing 
a system command or loading a program. Typical interrupts and the consequent processing include: 


Press READY ENABLE button. This causes the MCP to enable the keyboard for input. 


Opening or closing the serial printer cover causes the MCP to prevent or allow output to the printer 
accordingly. 


Loading a disk or cassette causes the MCP to read the label and perform the AVR procedure. 
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POWER OFF 


Logically power off all user disks (see PO command if under MCP control, or SAU PO command 
if under SAU control). 


Logically power off the system disk (see PO command if under MCP control). Wait until the system 
returns to the initial state, that is, PKi and PK2 are lit. 


If the PO command cannot be used, due to some system error, then the system should be halted by 
pressing the Load Enable button, causing the system to return to the initial state with PK1 and PK2 
lit. 
Remove all removable disk media. 
A mini disk can be removed as soon as the unit door is opened. 
A disk cartridge can be removed only when the red stop light is lit, assuming that the drive is 
functioning correctly. 


Power off the disk units (failure to remove disk media before this may result in subsequent media cor- 
ruption). 


Remove all cassettes from the system. 


Power off the main cabinet (this must be the LAST action after all peripherals have been switched 
affy 


Wakze 

Note on disk removal: 

There are only two situations when it is valid to remove a disk: 
where the MCP is not running and the disk is not in use. 
where the MCP is running, but the disk is a user disk which is logically powered off after using 
the PO command: note that the PO command does not cause a disk to become logically powered 
off if it is in use, but the PO will be completed only after all activity on the disk is complete. 


Note on power failures: 


If the main cabinet is switched off accidentally (for example, by power failure), remove all disks and 
cassettes before it is switched back on. 
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ROM SCANNING ALGORITHM FOR ROM LEVEL 4 


From the Initial State (PKs 1 and 2 illuminated), pressing PK2 initiates a ROM load routine which 
searches through all present disks until it finds a valid bootstrap code. 


The ROM search consists of two passes; the first looking for removable devices (1 Mb, 3 Mb and car- 
tridge disks) and the second looking for fixed devices (2011 and 211 disks). Each pass scans from the 
highest channel to the lowest and from the bottom drive to the top drive in each channel. 


If either a channel or a drive fault is encountered, the ERROR light is lit and the inverse of the channel 
address displayed on (Bank 2) PK1 through PK8. That is, PK] extinguished and PK2 through PK8 
lit indicates a fault on channel 0, PK2 extinguished and PK1 and PK3 through PK8 lit indicates a fault 
on channel 1, and so on. This type of error occurs after a two-minute timeout, if the scan encounters 
a powered-off SDI device (3 Mb or 211 disk). 


Pressing OCK1 causes the Caelus Primary or SDI Host Status to be displayed on PK1 through PK8 
(Bank 2) and the Caelus Secondary Status or SDI Device Status Byte 1 to be displayed on PK17 
through PK24 (Bank 4). 


Pressing OCK2 causes the SDI Device Status Byte 2 to be displayed on PK1 through PK8 (Bank 2), 
and the SDI Device Status Byte 3 to be displayed on PK17 through PK24 (Bank 4). 


Pressing the Reset key causes the scan to resume from the next drive in the case of a drive fault, or 
the next channel in the case of a channel fault. If both passes of the scan have been exhausted without 
a valid bootstrap being found, then PK1 through PK8 are illuminated. To re-attempt a Cold Start, 
it is necessary to press the Load Enable button, ensure that a disk containing a valid bootstrap is pres- 
ent on the system and is powered on, and repeat the above procedure. 


If either a channel or a drive fault is encountered, the ERROR light is lit and the inverse of the channel 
address is displayed on D1 through D8. The Caelus Primary or SDI Host status is displayed on PK1 
through PK8 and the Caelus Secondary or SDI Device Status Byte 1 is displayed on PK9 through 
PK16. Pressing the right hand Form Feed key causes the SDI Device Status Byte 2 to be displayed 
on PKI through PK8 and the SDI Device Status Byte 3 to be displayed on PK9 through PK16. From 
this state, pressing the left hand Form Feed key causes the Caelus Primary and Secondary Status, or 
the SDI Host Status and Status Byte 1, to be displayed. 


Pressing the Reset key causes the scan to resume at the beginning of the algorithm (that is, at the bot- 
tom of the highest channel). 
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ROM SCANNING ALGORITHM FOR LEVEL 5 ROMS 


These ROMs are fitted to B 96 systems as standard and are available for B 94s. They may be identified 
by pressing OCK3 while in the initial state (PKs 1 and 2 illuminated). The version number is then 
shown on Bank 4 lights as ‘‘.....0.0’? where ‘‘o’’ represents an LED on and ‘“‘.”’ represents an LED 
off. This is the binary representation of 5. The Level 5 ROMs permit the loading of the Coldstart 
Bootstrap (COLDBOOT) via PK1, or the Warmstart Bootstrap (WARMBOOT) via PK2. OCK3 dis- 


plays the ROM version number. 


If a hardware error is encountered while the ROM is searching for, or loading, a bootstrap, the ER- 
ROR light is lit and the channel number is displayed on PK1 through PK8 (Bank 2) by extinguishing 
the appropriate PK. For example, an error on channel 0 causes the ERROR light and PK2 through 
PK8 to be lit. Similarly, if an error occurs on channel 3, the ERROR Lights PK}, PK2 and PK4 
through PK8 are lit. See ‘“‘Hardware Error Conditions’’. 


Loading Coldstart Bootstrap — PK1 


From the initial state (PKs 1 and 2 illuminated), pressing PK1 initiates a ROM routine which clears 
the first page of memory (Page 0). It also initiates a load routine which searches through all present 
Burroughs minidisks and magnetic tapes until it finds a valid Coldstart Bootstrap code. 


This is accomplished as follows. 


ee pees t an ~ 
medium. If necessary, two scans are made. Each 


Cad 


Peripheral Channels are scanned to find a coidsiar 
scan is from channel 7 to channel 0. 


Scan 1: 


The first scan looks for a Coldstart Disk, that is, a 3 MB BSMII or 1 MB BSMD minidisk which has 
been initialized, reformatted or has had its Bootstrap replaced with the Coldstart Bootstrap (COLD- 
BOOT). 


If a Coldstart disk is found, COLDBOOT is loaded and control is transferred to COLDBOOT. (See 
Coldstart Bootstrap Algorithm.) 


If a Coldstart Disk is not found, a second scan is made. 
Scan 2: 


The second scan looks for a Coldstart Tape at load point, that is, a tape created by the LD utility, 
whose name is ‘““CLDSTRT’’. 


If a Coldstart Tape is found, the Coldstart Tape is searched for a file called ““CMSBCOT’’. If the 
file is found, COLDBOOT is loaded and verified. 


If the verification is successful, control is transferred to COLDBOOT. (Note the Coldstart Tape is not 
rewound.) 


If a Coldstart Tape is not found, the system halts with the ERROR light and all Bank 2 lights lit. 
Loading Warmstart Bootstrap — PK2 


From the initial state (PKs 1 and 2 illuminated), pressing PK2 initiates a ROM Load routine which 
searches through all present disks until it finds a valid CMS Warmstart Bootstrap code. 


2032801 8-49 


TT OO SC ee 


This is accomplished as follows. 


The peripheral channels are scanned for a Warmstart medium. If necessary, three scans are made. Each 
scan is from channel 7 to channel 0. 


Scan 1: 


The first scan looks for a removable Warmstart Disk, that is, a 3 Mb BSMII disk, 1 Mb BSMD or 
cartridge which has been initialized, reformatted or has had its Bootstrap replaced with the Warmstart 
Bootstrap (WARMBOOT). 


If a removable Warmstart Disk is found, WARMBOOT is loaded and control is transferred to WARM- 
BOOT. (See Warmstart Bootstrap Scanning Algorithm.) 


If a removable Warmstart Disk is not found, a second scan is made. 
Scan 2: 


The second scan looks for a fixed Warmstart Disk, that is, a 211 or 2011 fixed disk which has been 
initialized, reformatted, or has had its Bootstrap replaced with the Warmstart Bootstrap (WARM- 
BOOT). 


If a fixed Warmstart Disk is found, WARMBOOT is loaded and the control is transferred to WARM- 
BOOT. (See Warmstart Bootstrap Scanning Algorithm.) 


If a fixed Warmstart Disk is not found, a third scan is made. 
Scan 3: 


The third scan looks for a Coldstart Tape at load point, that is, a tape created using the LD utility 
whose tape name is ‘‘CLDSTRT’’. 
1. A search for a file whose file name starts with the seven characters ““CMSBOOT”’ is made. 
If the file is found, the WARMBOOT portion of the CMSBOOT file is loaded from the tape 
and its checkstring is verified. 
2. If the checkstring is correct, control is transferred to WARMBOOT. (The tape is not rewound.) 
If the checkstring is incorrect, the scan is resumed. 


NOTE 
WARMBOOT itself does not have the capability of searching for MCPX or 
SAU on magnetic tape. So, if no disk containing these files is ready, only 
Dump to Tape (PK4) and/or Dump to Disk (PK5) can be carried out. A 
complete Warmstart, that is, loading MCPX or SAU, can be carried out only 
if a disk containing these files is ready. 


3. If no Coldstart Tape is found, the system halts with the ERROR light and all Bank 2 lights 
lit. 
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ROM SCANNING ALGORITHM FOR LEVEL 6 ROMS 


The level 6 SYSTEM/MTR was designed for use in the B 95 system. The ROM includes numerous 
improvements over versions produced previously for use with other B 90 series systems. The B 95 is 
a totally data comm based system, so the ROM interface with this has now been enhanced. The enhan- 
cements to the ROM also allow the use of peripheral types introduced for the B 95 system. The ROM 
is split into two distinct 4 K byte sections. One half is the code to perform the ‘‘Power On’’ confidence 
routines. The other half contains the code to search for and load a required bootstrap. The bootstrap 
micro-code, once loaded, executes the required function requested by the operator. The system part 
of the ROM has the ability to branch back into the MTR routines if, at any time, it detects a possible 
hardware fault. 


The level 6 SYSTEM/MTR ROM requires a second ROM to control the data comm input and output. 
This ROM also contains all the messages displayed by the firmware based routines or the bootstrap 
code. 


The level 6 SYSTEM/MTR ROM must be used in conjunction with CMSBOOT version 3.04.59 or 
greater. This means that any disk from which the ROM is to obtain its bootstrap code must have the 
correct level of bootstrap in the sectors allocated for bootstrap information. 


Data Communications Requirements 


The level 6 SYSTEM/MTR ROM has the capability to display its current status or requirements to 
the operator through a terminal device. There are certain conditions which must be met if a terminal 
device is to be used to communicate with the ROM. 


The system must have a Data Communications Power Pak PCB installed in processor channel 5. This 
may be one half of a Dual Data Communications Power Pak PCB if one is available. T he interconnec- 
tion to the terminal must be asynchronous Two Wire Direct Interface (TDI) type. The terminal must 
be a TD 830 look-alike device which has been qualified for use with B 90 series systems. 


Suggested terminal styles and minimum firmware levels: 


Style Firmware Level 
TD 830 4.00 
TD 830J 4.00 
MT 983 3.08 
MT 985 3.08 
MT 993 3.08 
ET 1100 5.00 


NOTE 
The use of terminals which have a firmware level lower than those suggested, 
is not totally prohibited. The suggested levels represent the levels of firmware 
with which the ROM was tested. 


The internal switch settings of the terminal must be set to allow for TDI operation. In addition, the 
terminal must have enough video RAM available to allow two page operation. The address registers 
of the terminal require to be set to @01 (hex 30 31). The ROM will attempt to communicate with 
the user through a suitably configured terminal at one of five possible line speeds. The line speeds 
searched through are 38400, 19200, 9600, 4800 and 1200 baud, scanned in that order. Failure to locate 
a ready terminal after all the possible line speeds have been checked, causes the ROM to enable key- 
board input only. If the initialize button is pressed, a scan will again be made to find a usable terminal. 
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Keyboard Input and Output 


If a suitable terminal is not available, it is possible to initiate the loading of software from the MTR 
keypad. Any error conditions detected will be displayed on indicator banks located above the keypad 
keys. 


ROM Start Up Cycle 


After the system is powered on, the ROM performs routine confidence checks to verify that the hard- 
ware is fully functional. Once it has been ascertained that the system is functional, the firmware enters 
SYSTEM mode, allowing software to be loaded into memory. The following provides an overview of 
the ROM controlled start up cycle. 


Number Description of Action Performed 


1 I/O Confidence Test 
All LEDs on the keyboard are set on, LEDs 7 to 0 on the FAULT CODE bank 
are then set off sequentially, followed by LEDs 7 to 0 on the START CODE bank. 
If a failure is detected, the whole test will be repeated continually until the system 
is powered off or initialized. 


2 Processor Confidence Test 
After the processor confidence routine is performed, if no errors are detected, the 
system can now begin to display its progress to the operator. From this point 
onward, it has been presumed that a terminal was found to be available. After 
successfully passing the processor confidence test, the message ‘‘System Confidence 
Test’ is displayed. This message appears on page 2 of the terminal and all further 
confidence test output is scrolled upwards. 


3 Memory Confidence Test 
The message ‘‘Starting Memory Test ...... Please wait ’’ displayed on the terminal 
indicates that the memory test has begun. The message ‘‘Memory Test completed’’ 
indicates the end of the memory test. If an error is found on memory page zero, a 
message indicates this and an attempt is made to locate error free memory. On final 
completion of the memory test, the operator is prompted to insert an MTR disk. 


4 Timer Confidence Test 
No indication is provided to inform the user that the internal timer test has started. 
If no failure is detected, the message ‘Internal timer test complete’’ is output and 
the test sequence continues. 


5 Winchester Disk Controller Confidence Test 
Tests are made to all drives attached to each Winchester controller. If no failures 
are detected on a disk controller, the confidence routine moves on to the next stage. 


6 Check Floppy Disk Drive for MTR Disk 
After successfully completing the preceding confidence tests, the ROM scans the 
floppy disk drives on the system in search of an F. E. bootstrap. If no such 
bootstrap is detected, the message ‘“CONFIDENCE CHECKS SUCCESSFULLY 
COMPLETED” is displayed and the terminal returns to page 1. 
This indicates that the MTR carried out by system ROM has not detected any 
failures. If any failures are notified by the MTR routines, the user is prompted to 
insert an MTR disk and run the full disk based confidence routines. 


7 Enter System Mode 
This is the point where a user is prompted to supply software loading instructions 
to the firmware. A menu screen is sent to the user’s terminal if one is available and 
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(continued) 

Description of Action Performed 
the LEDs above keys 0, 4, 5 and 6 are set on indicating they are enabled. The 
option selection can be made either from the user’s terminal or by the enabled keys 
on the systems keypad. 
The options available to the user are as follows: 
4. Start normal operation.......WARM START) 
5. Save contents of memory for analysis ... (DUMP MEM) 
6. Start independent utility program..... (STAND ALONE) 
0. Copy software from removable media ....(COLD START) 
The numbers used on the menu screen correspond to the number of the key which 
initiates the function. 


Return from Selected Option 

Once the operator has finished using the required function and terminates its use, 
the system performs the I/O confidence test, checks for an MTR disk and returns 
to System Mode. This may not be the case if a disk with F. E. bootstrap is found 
to be in the floppy disk drive. In this case the full ROM based MTR cycle will be 
executed once more. 
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COLDSTART BOOTSTRAP ALGORITHM 


When the Coldstart Bootstrap (COLDBOOT) has been loaded successfully, COLDBOOT tries to load 
the utility called COLDSTART from the device from which COLDBOOT was loaded. 


If the utility COLDSTART is not found, the ERROR light is lit and PK1 through PK8 are extin- 
guished. 


Pressing the RESET key after COLDSTART not found on hardware error has no effect — that is 
it continues to light ERROR and display channel address, and OCK options still remain. 


To try again, user must mount COLDSTART medium and re-initialize machine. 


If the error persists, seek technical assistance. 


WARMSTART SCANNING ALGORITHM 


The successful loading of CMS bootstrap (WARMBOOT) causes PK3 through PK6 to be illuminated. 
Also, OCK4 is enabled to display the WARMBOOT version number in a two part process (see Hard- 
ware Error Conditions for format). Note PK1 through PK8 are on bank 2. 


When PK3 (execute MCPX), PK5 (memory dump to disk) or PK6 (execute SAU) is pressed, a two 
pass scan algorithm is invoked. This is similar to the first two scans described in ‘‘Loading Warmstart 
Bootstrap’, but with the following differences. 


To indicate that a channel or drive fault is encountered by the bootstrap, the bootstrap displays the 
channel address on PKi through PK8 by iliuminating the channel PK and extinguishing the rest. That 
is, a fault on channel 0 is indicated by PK1 being lit and PK2 through PK8 being extinguished. A 
fault on channel 1 is indicated by PK2 being lit and PK1 and PK3 through PK8 being extinguished 
and so on. 


Similarly, when both passes have failed to find the desired file, PK1 through PK8 are extinguished 
and only the ERROR light is illuminated. 


The time-out incurred by the bootstrap encountering a powered off SDI device is 70 seconds. 


When a channel or drive fault is encountered, pressing the RESET key causes the bootstrap to continue 
its scan at the next lowest drive or channel. 
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MEMORY DUMP TO MAGNETIC TAPE 


This only applies to systems with ROM level 5. 


The system must be in the CMS Warmstart Bootstrap state, with PK3 to PK6 lit. 


NOTE 
The release level of the bootstrap must be 3.04 or higher. 


If the system is in the initial state, press PK2 to load a Warmstart Bootstrap. 


Insert a magnetic tape with a write ring into the drive and press the LOAD and ONLINE buttons on 
the tape streamer. 


Press PK4. 


The contents of RAM are written to the magnetic tape. During the dump, an indication of the memory 
address being dumped is displayed on bank 4. When the dump is complete, the system returns to the 
Bootstrap state (PK3 to PK6 lit). The magnetic tape is labelled ““MEMDUMP/MEMORY’’. 


Press the ONLINE and then the UNLOAD buttons on the tape streamer, remove the magnetic tape 
and remove the write ring from the tape. Clearly mark the tape with the date and time and submit 
it with details of the fault to your support personnel. 


For possible errors see ‘‘System Load Errors’’. 


NOTE 
If the Warmstart bootstrap (WARMBOOT) was loaded from magnetic tape 
and this tape is to be used for the dump, the tape must be rewound to the 
load point. This is because the ROM leaves the magnetic tape past the load 
point to prevent accidental writing to the magnetic tape. 
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MEMORY DUMP TO DISK 


Before memory dump to disk can be initiated, the following conditions must be met: 


If the system is configured with a console/MTR keyboard, the CMS bootstrap WARMBOOT must 
have been loaded and entered. This is indicated by PK lights 3, 4, 5 and 6 only being lit. 


To initiate the dumping of memory to disk, press PK5. 


If the system is configured with an ELPRO keypad, the system must have been initialized and status 
lights 0, 4, 5 and 6 only being lit. 


To initiate memory dump to disk, press PKS. 
Memory dump to disk continues as follows: 
1. The system searches for a file named MEMDUMP on a removable disk. 


1) Higher numbered channels are scanned before lower numbered channels; higher numbered 
drives are scanned before lower numbered drives. 


2) If a MEMDUMP file exists on a removable disk, the system will check that the second digit 
of byte 44 of the Disk File Header contains 0; otherwise it will not dump memory to the 
disk. This check ensures that cither: 

a. memory has not been dumped to the disk since the MEMDUMP file was created by the 
utility GEN.DUMPEL, or 


b. since memory was last dumped to the disk, it has been submitted to PMB90 for analysis. 


3) The system will begin dumping memory from location #1000 to the first removable disk 
found to contain a valid, single-area MEMDUMP file. 


4) If the MEMDUMP file is not large enough to contain the memory to be dumped, the system 
will dump as much memory to the file as it can hold and then wait for user action, displaying 
#AA (on Bank 2 lights of a console/MTR keyboard, on status lights of an ELPRO keypad). 
The user must load another MEMDUMP removable disk (if additional disks have not already 
been loaded) and press the console/MTR RESET key or the ELPRO key 7. The system will 
then resume dumping memory to the removable disks from the location following the last 
area dumped. 
NOTES: 
— As many disks as are required can be loaded. 
— Cartridges and floppy disks are both considered removable disks for dumping purposes. 
— Once dumping to a removable disk has begun, dumping to a fixed disk is inhibited. Conse- 
quently, if it is desired to dump memory to a fixed disk, ensure that no removable disks containing 
MEMDUMF files have been loaded. If it is desired to dump to removable disks, ensure that sufficient 
MEMDUMP space exists on the removable disk (or disks). 


2. If the system cannot find a valid MEMDUMPF file on a removable disk, it searches for a MEM- 
DUMP file on a fixed disk. 


1) Highter numbered channels are scanned before lower numbered channels; higher numbered 
drives are scanned before lower numbered drives. 


2) No check is made on the Disk File Headers of MEMDUMP files resident on fixed disks. 
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3) The system will begin dumping memory from location #1000. The MEMDUMP file must be 
large enough to contain all of remaining memory. 


3. After all of memory has been successfully dumped to disk, the system waits, and displays on 
the console/MTR PK lights 3, 4, 5 and 6 = warmstart options, on the ELPRO status lights 


0, 4, 5 and 6 = start options. 
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SYSTEM LOAD ERRORS 


The following table of errors covers all symptoms found during start-up of any B 90 except the B 95, 
warmstart, memory dump to disk or cassette, or entry to Stand-Alone utilities. 


Symptom 
Sequential lighting and 
extinguishing of lights does 
not occur on entry to Initial 
State (for example, depressing 
Load Enable button). 


From Initial State, PK2 is 
ignored. 


Depression of PK2 causes 
numeric light to be lit. 


Depression of PK2 causes 
keyboard lights plus ERROR 
light to be lit: 


(a) PK1, PK8 (Bank 2) lit 

(b) One of PK1-PK8 (Bank 2) 
extinguished, all other 

(Bank 2) lit 


All keyboard indicators flash. 


Print head does not initialize 
at start of warmstart. 


Memory dump to disk: 
Depression of PKS causes 
ERROR lit, PK1-PK8 (Bank 
2) extinguished. 


Memory dump to disk: 
ERROR light is lit during 
dump. One lit. Bank 2 (PKI- 
PK8) light lit. 


Memory dump to disk: system 
warmstarts. 
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Possible Causes 


MTR switch in wrong 
position. 


Keyboard locked in ‘‘shift’’ 
mode. 


PK1 was depressed by mistake 
(this clears memory). 


No bootstrap found (disk not 
initialized correctly). Disk 
media or drive fault. 


Memory parity. 


Console printer faulty. 


No MEMDUMP file found on 
disk. 


MEMDUMP file on disk is 
too small to hold memory 
contents for this machine. 


PK3 was depressed instead of 
PKS. 


Suggested Action 


Set MTR switch to ‘‘normal’’. 
Depress Load Enable button. 


Depress shift key. Depress PK2. 


Depress Load Enable. Depress 
PK2. 


Press RESET to continue scan. 
Check on disk used. Reload 
with correct disk. Press Load 
Enabie. Press PK2Z. See bdeiow 
for diagnosis. Note PK lights. 
Check that disk is not at fault 
by using disk in another drive. 
Power off faulty disk, replace 
with backup copy. Request 
technical assistance. 


Depress Load Enable, depress 
PK1 (to clear memory), then 
depress Load Enable again, and 
retry. Request technical 
assistance if not successful. 


Open and close cover. Repeat 
warmstart. Request technical 
assistance. 


Load a disk with a MEMDUMP 


file and depress PK2 then PK5 
to retry the dump. 


Load disk with larger 
MEMDUMP file; depress PK2 
then PK5 to retry the dump. 


Memory dump cannot now be 
taken. Allow warmstart to 
complete. 


8-59 


(continued) 


Symptom Possible Causes Suggested Action 
Entry to 8.A.U: Depression SAU could not be loaded Note D and PK lights. Remove 
of PK6 causes one D light, from disk: disk error. disk, replace with backup copy. 
plus ERROR, to be lit. Press Load Enable, PK2 and 
PKS. See below for diagnosis. 
Entry to S.A.U: load stops Console printer not ready, or | Check forms transport closed. 
with all keyboard lights lit. datacomm terminal not in Check printer cover down. 
receive mode. Check levers in correct position. 


Utility should continue. 
Depress RCV on datacomm 
terminal with lowest address. 


Diagnosis of Disk Errors at System Load Time 


If an error occurs during the previously described scanning of the channels by the ROM, the system 
will illuminate the error light and the number will be displayed on Bank 2 (PK1-PK8) lights. That 
means that the light on Bank 2 which is not lit indicates the channel on which the error occurred, 
where the channels have to be counted from 0 to 7 on the lights from left to right. 


wae awe oe ww ey 


At this moment the machine will wait for keyboard input. The following keys are enabled. 


OCKI: to display 
BANK 2 (PK1-PK8) — Primary status 
BANK 4 (PK17-PK24) — Secondary status of a removable disk, device status 1 of BSMDII 
or 211 fixed disk, or data transfer of magnetic tape. 


OCK2: to display 


BANK 2 (PK1-PK8) — Device status 2 of BSMDII or 211 fixed disk, or transport status 
of magnetic tape. 
BANK 4 (PK17-PK24) — Device status 3 of BSMDII or 211 fixed disk or dynamic status of 


magnetic tape. 


OCK3: to display 


BANK 4 (PK17-PK24)  -— contents of the ROM identity byte. 
RESET — to continue the channel scan at the next lower-numbered channel/drive. 
NOTE 
All status displays are bit-reversed. 
NOTE 


This ROM scanning and error indication is not applicable on the B 95. 


Caelus Device Primary Status 
Bit Interpretation 


0 Drive Addressed (0 = Upper, 1 = Lower} 
1 0 = Seek complete 

2 0 = End of cylinder 

3 0 = Search complete 

4 0 = Secondary status condition 

5 1 = Operational 

6 0 = Seek complete 

7 1 = Status OK 
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Caelus Disk Secondary Status 


Ly 
-~ 


“HMA Ph Whe © 


Ignored 

1 = on cylinder 

0 = Illegal seek 

0 = Write inhibit 

0 = Sector not found 

0 = LRC error (parity) 

0 = Illegal command sequence 
0 = Device error 


SDI Host Controller Status 


Bit 
012 


“AANA WwW 


SDI Device 
Bit 
0 


| 
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Apart from MTR use, these bits should be set to 001, indicating that the Host 
Controller is ready to accept a Device Controller command or Ist segment data 


from Host. 
1 
Buffer available 


| eel conn el el 
hou wd uel 


Status 


Byte 1 


Drive No. 

Bit 0 (LS) 

Drive No. 

Bit 1 

Drive No. 

Bit 2 (MS) 

1 = Transfer Delay 


1 = N Sectors Before 
Read 

1 = N Sectors Before 
Write 


Operation Complete 


Interrupt 


Buffer not empty 
Interface timeout (hardware fauit) 
Interface retry exceeded (hardware fault) 


Interpretation 


Interpretation 


Device Controller Status available 


Byte 2 
Error 


Search Unsuccessful 
Corrected Data 


Command not 
Accepted 
Command Error 


Address Error/End 
of Drive 
Mandatory Int. to 
Host 

Address not Found 


Byte 3 
1 = Not Ready 


1 = Disk Expiring 


1 = Write Protected 


1 = New Disk 

1 = Danger 

1 = Confidence Test 
Completed 

1 = Temporarily 
Unavailable 

Unassigned 
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Magnetic Tape Device 


Primary Status 
Bit 


Tape mark found 


End of record 


peweh bemesh Pease fh fer peru fl 


iru dd vo ven 


Secondary Status 


Bit 
0 
1 


No 


NAMA h WwW 


* Does not result in request to host 


Byte 1 


Tape corrected error 
Tape hard error 


Parity error from 
formatter 

Controller detected error 
Service too late 

1 = Gap time out 

not used 

not used 


Operation complete 
Data transfer exception (reason in secondary status byte 1) 
Transport state condition (reason in secondary status byte 2) 


Interpretation 


Record bigger than expected 
Record smaller than expected 


Byte 2 


Transport address * 
1= Transport address * 


1= Write Inhibited tape 


1= Drive online 

1= Drive Ready ** 

1= Tape past EOT 

1= Tape at load point * 
1= PE tape ID found at 
BOT * 


** Required only on change in transport status 
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Request Data Transfer (Buffer empty if write, buffer full if read) 


Byte 3 


1= Formatter busy * 
1= Data busy * 
1= highspeed 
Q= low speed 
1= high speed 
0 = low speed 
Tape streaming * 
not used 

not used 

not used 

1= Rewinding * 


ERRORS UNDER MCP CONTROL 


The following table of errors covers many symptoms found while using the B 90 under normal control 
of the MCPX, with suggested causes and actions to take. 


Symptom 
Unidentifiable problem 


Little happening, with D2 on, 
D3 off most of time 


PK lights 17 to 24 flashing 
with ‘‘DF’’ pattern 
(on,on,off,on, on,on,on,on) 


PK lights 17 to 24 flashing 
““AC’’ pattern 

(on, off,on,off,on, on,off,off) 
or “‘AD”’’ pattern 

(on, off,on,off,on,on,off,on) 


Non-zero retry count on PO 
of system disk 
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Possible Causes 


Hardware disk I/O error 
during MCP task. 


See below: 


hardware disk I/O error 
during MCP disk directory 
operation. 


Logical error in disk directory 
due to previous fault. 


Deteriorating disk 
performance. 


Improper care of removable 
disks: possibly failure to re- 
initialize disks after long use. 


Suggested Action 
Use backup copy of MCP 


Tf 1 4+ 3 nS 
If console not in use, set GT 


ON. If light pattern above PK17 
to PK20 is: on, on, off, on, 
then thrashing is confirmed : D 
lights 4 to 7 indicate mix 
number of executing task. Try 
entering MX to clear condition : 
if not successful, take memory 
dump and do clear start : 
request technical assistance. 


Take memory dump: request 
technical assistance to analyze 
memory dump to find disk 
address for use in fixing the 
disk. To help find the fault, 
warmstart and run the KA 
utility on the system disk before 
executing any programs. (See 
KA, section 4). If shows any 
‘““AREAS ASSIGNED TWICE”’ 
the disk directory may be bad. 
DO NOT USE THIS DISK until 
recovery operations have been 
completed. 


(Take recovery action as for 
“DF”? messages above: DO 
NOT USE THE DISK until 
recovery action is completed.) 


Request technical assistance to 
fix the disk. 


Rerun using backup disk : 
analyze corrupted disk using 
S.A.U. PDX function and 
report. 


Ignore if 10 or 20 during 
normal running in one day. Call 
field engineer if greater rate 
than usual rate for the site. 


All frequently used removable 
disks should be cleaned and re- 
initialized regularly. 
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Symptom 
Logging not taking place. 


PD, RM function not 
available. 


Cannot run data comm. 


System not active: programs 
in mix but D-light pattern 
does not change; keyboard 
input (for example, MX) is 
possible. 


System not active : programs 
in mix but D-light pattern 
does not change; keyboard 
input (for example, MX) 
causes error bell to ring, or 
remote SPO mx is only 
scrolled to the bottom line. 
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(continued) 
Possible Causes 


SYS-SUPERUTL not on 
systems disk. 


TL not on systems disk. 


Logging not specified in 
SYSCOMFIG file. 


No SYS-SUPERUTL 


SYS-SUPERUTL already 
performing one of its 
functions (see discussion in 
section 4). 


No NDLSYS file on system 
disk. 


NDLSYS file does not 
correspond to actual network 
on machine. 


NDL.INTERPX not present 
on system disk. 


No MCS program. 


Program swapped out waiting 
on memory. 


Console file input in process. 


System printer is jammed. 


Peripheral (possibly line 
printer) hang. 


Suggested Action 


Load SYS-SUPERUTL to 
systems disk. ; 


Load TL to systems disk. 


Rerun CONFIGURER and 
warmstart. 


Load SYS-SUPERUTL to 
systems disk. 


Check with MX if SYS- 
SUPERUTL is performing a 
function (mix-number 12 gives 
the name of the function): wait 
then re-enter command. 


Load NDLSYS file (you may 
need to run an NDL 
compilation). 


Load correct NDLSYS file; or 
recompile NDL program. 


Make sure the correct interpreter 
(for example MICROPOL) is 
named NDL.INTERPX and 
located on the system disk. 


Ensure that the correct MCS is 
executing as well as any user 
data comm program. 


Enter <mix> GO to resume 
program execution; if symptom 
persists, program is too large 
for available memory. 


Complete input using an OCK 
key. 


Open and close printer cover to 
initialize print head. Repeat if 
not successful first time. If still 
not successful, perform a 
warmstart. 


Enter CL command. If not 
successful, make peripheral ready 
or not ready; switch it off or 


Symptom 


System initializes (PK1 and 
PK2 lit) 


PK lights 17 to 24 flashing 
(pattern other than above) 


All keyboard lights flash. 


Program load taking long 
time : keyboard disabled and 
D lights 4 to 7 flashing. 


Hissing sound from disk 
drive. 


Non-functional disk drive. 


I/O errors from disk. 
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(continued) 
Possible Causes 


MCP software error. 
Corrupted MCP code file. 
Unexpected hardware error. 


Unknown MCP error. 


MCP has detected an error 
condition from which it 
cannot recover. 


Memory parity. 


Program loaded thrashing due 
to lack of available memory; 
too many or too large 
programs in mix. 


Disk drive heads are damaged. 


Hardware fault on drive. 


Non-function disk drive. 
Crashed disk head. 


Physically damaged disk 
media. 


Suggested Action 
on; insert and unload spare 
cassette in cassette drive. If this 
fails, take memory dump, report 
fault and warmstart. 
Note: never load or unioad disk 


media 
SALUNELL 


are in use, until system has 
returned to initial state. 


: . 
or cassette media which 


Take memory dump, report 
fault and warmstart. 


Take memory dump, report 
error, rerun on backup disk. 


Take memory dump, report 
error, re-warmstart. 


Take memory dump, report 
error, attempt to rerun. If still 
not successful, request technical 
assistance. 


Refer to section on MCP 
diagnostic messages for further 
details. 


Initialize system, and rerun. If 
still faulty, request technical 
assistance. 


Try keyboard input. If this fails, 
initialize system and retry. 


Stop work. Remove the disk 
from the damaged drive. THIS 
DISK IS PROBABLY 
DAMAGED, DO NOT LOAD 
ANY OTHER DISK INTO THE 
DRIVE. Request technical 
assistance. 


Load a good disk on drive 
(UNLESS IF DRIVE HEADS 
HAVE CRASHED), run SAU 
LS utility. If this produces 
errors, the drive is faulty: call 
field engineer. 


See above. 
See above. 
Replace with new disk media. 
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Symptom 


(continued) 
Possible Causes 


Disk media has bad areas. 


Suggested Action 


Run CHECK.DISK to report on 
parity errors. Run KA to give 
disk directory analysis: if this 
shows AREA MISSING or 
AREA ASSIGNED TWICE, run 
SQ <diskname> VERIFY to 
recover the area which is 
missing or which has been 
assigned twice. 


Use backup disk for system 
files. Re-cover any other files by 
attempting to COPY them one- 
by-one from the corrupt disk to 
a good disk. 


ERRORS DURING WARMSTART OF A CONSOLELESS SYSTEM 


To warmstart a consoleless system (for example, B 93, B 94, B 95 and B 96), the following files must 
reside on the system disk: 


MCPX 

BILINTERPX 

SYSLANGUAGE 

SYSCONFIG 

NDLSYS 

NDL.INTERPX 

MCSOBJ 

MCSWARM These files may have other names 
MCSIN 


If one or more of these files is missing or disturbed then the system will not start. In that case an 


error code is displayed on the keyboard lights. Table 8-1 gives an explanation of these errors. In the 
light pattern a 0 indicates the light is off, an X indicates the light is on. 


Table 8-1. Consoleless System Error Codes 


Fiabe Date iti 
i Lignt rater | Condificn 


Suggested Action 


0006 000X NO SYSCONFIG| The system disk must contain a SYSCOMFIG file. Use 
SAU COPY to copy a good SYSCONFIG file to system 
disk, then restart the system. 


0000 00X0 INVALID MCS The zip-text in the SYSCONFIG file is invalid. Use SAU 


ZIP TEXT | COPY to copy a good version of SYSCONFIG to the 
system disk. 
0000 0OXX PROGRAM MCS named in SYSCONFIG file is not found — either 


NOT FOUND zip text in SYSCONFIG incorrect or MCS not on disk. 
Use SAU COPY to copy a good MCS to disk or use SAU 
CH to change the name of the MCS to the name 
requested by the SYSCONFIG file. 


0000 0X00 INTERPRETER | BILINTERPX or NDL.INTERPX not on disk or MCS 
NOT FOUND code file corrupt. Use SAU COPY to copy these three files 
to disk. 


0000 OXOX NO USER DISK | Loading of the MCS or NDLSYS has failed due to lack 
of disk space. Use SAU RM to remove unneeded files 
from disk and start again. 


0000 OXX0 MCS ALREADY | An attempt was made to start a second MCS. If the 
PRESENT current MCS supports remote SPO, the system is 
unaffected, else use SAU CH to change the name of the 
remote spo capable MCS to the name of the MCS first 
started and restart the system. 


0000 OXXX DISK ERROR There is a disk parity error on one of the files to be 
loaded. Save all the files from the system disk using SAU 
COPY then re-initialize the disk and load all files back to 
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Table 8-1. Consoleless System Error Codes 


(continued) 


system disk. Then warmstart the system. In case the system 
has only tape as a backup system, the system has to be 
coldstarted using the COLDSTART utility with the 
initialize option. 

The MCS zipped is corrupted. Use SAU COPY to copy a 
good MCS to system disk. 


Load of datacomm failed because the NDLSYS file is not 
suitable for this system. Use SAU COPY to copy a 
suitable NDLSYS, NDL.INTERPX combination to system 
disk. 


The NDLSYS, NDL.INTERPX combination may not 
support SPIM. Use SAU COPY to copy a suitable 
NDLSYS, NDL.INTERPX combination to disk or copy an 
NDLSYS, NDL.INTERPX combination which supports 
ETS (Enhanced Terminal Spo), in which case SPIM is not 
needed. 


0000 XOXX MCS WENT The MCS went DS/DP. On system disk a dumpfile is 
DS/DP created called DMFILxx, where xx is the mix number of 
the MCS. Normally it will be DMFILO1. Restart the 
system and ask for technical assistance to analyse the 
dumpfile. Keep a copy of the spo-log. If the MCS goes 
DS/DP again during warmstart, use SAU COPY to copy a 
good version of the MCS to disk. 


The light pattern will be flashing. It indicates that there is | 
no SYSLANGUAGE file on disk, or that the MCP could 
not read it. Use SAU COPY to copy a good version of 

SYSLANGUAGE to the system disk. 


Light Pattern 


CODE FILE 
ERROR 


DC LOAD 
ERROR 


SPIM WENT 
DS/DP 


0000 XX00 NO 
SYSLANGUAGE 


If any other error occurs during warmstart, request technical assistance. 
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B90 DEPENDENT UTILITIES 


The following pages describe those system utilities which run under MCP control but which are relevant 
only to the B 90 CMS software. 
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a 
BUILDTRANS (Build Translation Table) 


CMS provides translation tables for all versions of the keyboard, screen, CRT, line printer and serial 
printer currently supported by the MCP. The user has the capability to specify a non-standard transla- 
tion table for any of these devices, by setting up SYSCONFIG (see CONFIGURER and SYSTRANS 
for naming conventions) appropriately. At warmstart the MCP uses SYSCONFIG to select the desired 
translator table(s) from the file SYSTRANS. See SYSTRANS FORMAT for details of naming and for- 
mat. 


The translation of devices is achieved by: 


1. Modification of existing translation files. 
2. Creation, and subsequent modification, of new translation files consisting 


1) entirely of newly defined tables. 
2) of translation tables acquired from existing files. 
3) of a combination of 1) and 2). 


Limitations 


Buiidtrans wili aiiow the creation of table.names of any format. However, when the table is to be used 
by the LT command, the table.name should have the format: 
< device >.< variant >. <country/language > . V <version.no > 


See SYSTRANS Format later in this section for details. 
There is a limit of 200 tables and 400 directory entries for a new translation file. 


For an old file there is a limit of twice the number of tables present in the file, or 200, (which ever 
is the greater), and twice the number of directory entries in the file, or 400 (which ever is the greater). 
Input limitations: 

For a screen device, this limit will be 80 characters. For other devices, a maximum of 120 characters 
can be entered. 

Only MODE 0 and MODE 1 translation tables can be used on the B 90. 


MODE 1 Translation tables for input translation must be used with a keyboard device which has a 
mode key or equivalent. 
The only supported devices on a B 90 for translation are: 


B 91 and B 92 Keyboards 
CRTs 

B 91 and B 92 serial printers 
Line printers 


This is true only if the hardware device is supported for the B 90 in question. 
Operating Instructions 
The BUILDTRANS utility enables the user to perform the required operations to construct/modify 


translation tables for devices. 
There are three types or modes of translation tables. 
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Mode O 


This is the simplest translation table, where there is one entry for each code in the character set. The 
table size is 256 bytes. 


Mode 1 


In this mode each internal code has n number of output codes. Each internal code has one entry, n 
bytes in length, where n = length of each entry (the length is fixed for all entries). This mode is used 
for devices such as current CMS Arabic line printers, where each internal code is translated to either 
i or n characters. Unused print codes for each entry are set to hexadecimal FF. 


Mode 2 (not implemented on B 90) 


This is a completely general table which allows code Ci, where i is greater than or equal to 0 and less 
than or equal to 255 (0 < i < 255), to have j output forms, where j is greater than or equal to 0 
and less than or equal to 255 (0 < j <255). If j = 0 then no translation will take place. This mode 
allows complete contextual analysis of the language being translated. 


Shift Codes 


Each translation table requires shift codes. This allows the translation table to be used with a 7 bit 
device, (that is, the device can only recognize 128 codes, compared with 256 for an 8 bit device). The 
format of the table using shift codes is two 128 entries making a 256 entry tabie. 


The value of @0000@ hexadecimal should be entered for devices which use an 8 bit interface. For 
devices which use a 7 bit interface, the 1 byte shift out code followed by the 1 byte shift in code, 
for the device, should be entered as a 4 digit hexadecimal number. 


Workfile Creation 


The utility operates on a workfile which can be created in one of three ways. If an existing translation 
file is to form the basis of the new file, a GET of that file can be done. If no existing file is sufficiently 
suitable, an empty workfile can be created by doing a MAKE. In addition, it may be possible to RE- 
COVER a previously created workfile. 


When a workfile is available, operations can be performed on it. 
For example : 


i. A table from an existing translation file can be INCLUDEd in the workfile, providing that a 

table of the same name does not already exist in it. 

A new user table can be built using the BUILD function. 

. A user table can be DELETEd. 

. A user table can be altered using EDIT. 

_ Tables and/or directory entries can be LISTed. 

_ When the workfile is complete, a new translation file can be created from the workfile using 
the SAVE option. 

7. If the workfile is no longer required, it may be REMOVEd. 


AUnhwWhy 


A subsequent GET, MAKE or BYE is only permitted if the workfile has been SAVEd or REMOVEd, 
or no modification has been performed on it. 
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Initiation and Working Mode 


The initiation of the BUILDTRANS utility and many of the functions used are similar to the operation 
of CMSCANDE. 


If a data comm System is present, the program can be executed from a TD 800-type terminal device. 
However, if data comm is not present, or access is denied by the MCS, the utility attempts to use 
console I/O. If this fails, then Displays and Accepts will be used. This same procedure is used if data 
comm was being used but the MCS is terminated during the execution. 


If a data comm failure is detected during program execution, a message is sent to the SPO, giving 
the error status and a choice of options : 


ABORT removes the work files, closes the input file (if present) and goes to End Of Job. 
OK returns control to the user and ignores the offending message. 
SPO directs Output/Input to the SPO via a Display/Accept 
GO attempts to transmit the message again. 
Functions 


The functions used by BUILDTRANS utility are similar to those of CMSCANDE. The available func- 
tions are: 


GET, MAKE, INCLUDE, LIST, BUILD, EDIT, DELETE, LET, SAVE, REMOVE, RECOVER 
and BYE. 


GET 
GET -————- < filename > —_ 


(For example: GET SYSTRANS) 


GET causes a workfile to be generated from the file supplied. It is only permitted after a SAVE, RE- 
MOVE or a previous GET/MAKE when no subsequent alteration(s) have been performed. 


MAKE 


Sees SHAKE ae Filananio ——_ 


(For example: MAKE MYSTRANSFILE) 


MAKE causes an empty workfile to be generated. The same restrictions as for the GET function apply. 
INCLUDE 


ane INCLUDE ————————_ < tablename > ———"-. FROM —=———— < filename > ——— 


(For example: INCLUDE LP.B924930.MYTAB.V1 FROM OTHERFILE) 
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INCLUDE copies an existing table from a named translation file to the current workfile, but only if 
a table of the same name does not already exist in the workfile. INCLUDE is only permitted if a work- 
file is already present. 


LIST 


— ALL ———— 


[ooo oye = 
LIST ee DIR ae aa PRINT >t _—_——— 4 
< tablename > 


(For example: LIST LP.B924930.MYTAB.V1 PRINT) 


LIST outputs information from : 


1. the directory of the workfile, or 
2. a translation table, or tables, contained in the workfile, or 
3. a combination of 1 and 2. 


The output will be directed to the device from which the function was requested. However, by specify- 
ing PRINT, output will be directed to a hard copy device. 


if data comm is being used, and the PRINT option was NOT selected, then the function can be termi- 
nated prematurely by entering ‘‘BRK’’. The utility then returns to the state existing prior to receipt 
of the LIST request. 


If output is to a screen device, then BUILDTRANS gives the user an option to end the list or to contin- 
ue after each screenful. In addition, if the entire file is being output, then this option applies after 
each complete table has been output. 


BUILD 


< tablename > ——- 


BUILD 


(For example: BUILD LP.924930.MTTAB. V2) 


BUILD allows a new user table to be defined, providing that a table of that name does not already 
exist in the current workfile. 


Details about the translation mode and, if using mode 1, the length of the translation elements, are 
requested. 


An implementation limit of 10 bytes per byte to be translated will be imposed. The utility outputs the 
hex value to be translated, and the user enters the required value(s). A null response causes hex FF 
to be inserted in the appropriate position(s) in the table for modes 0 and 1, and a length of zero for 
mode 2. 


Entering END causes the rest of the table to be initialized to the appropriate values depending on the 
mode; that is mode 0 and 1 will have hex FF written to the remaining positions. Mode 2 causes a 
length of zero to be inserted in the index table for each remaining item. 
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EDIT 


EDIT ———=—=—=—=_ <_ tablename > 


< starting-byte > 


(For example: EDIT LP.B924930.MYTAB.V1 AUTO 20) 


EDIT performs alterations on any user table in the workfile. By specifying AUTO, BUILDTRANS out- 
puts the hex value to be translated, starting at the value supplied, or at zero if no value is specified. 
BUILDTRANS then expects the new table value to be entered. On accepting this value, the next value 
to be translated is output, or EDIT terminates if the last value output was FF. A null reply causes 
the default value to be inserted. 


NEXT causes the current entry to be retained and the next value to be translated will be output. If 
the AUTO option is not selected, then two hex numbers must be entered, separated by at least one 
space, after BUILDTRANS has issued a prompt. The first number is taken as the byte to be translated, 


and must be in the range 6 to FF. The second number is taken as the table value and must be of 
the correct length. A utility limit of up to 20 hexadecimal characters for this second value is imposed. 


Entering END exits from this mode and the rest of the table is left untouched. 


DELETE 


< tablename > ——_ 


DELETE 


(For example: DELETE LP.B924930.MYTAB. V2) 


DELETE removes the specified user table, if it exists, from the workfile. 


NOTE 
It is not possible to delete a table-name pointing to to a system table. 


EET: 


ae LET OR _ < new-tablename > os CEQUAL ——————_ K< old -tablename > —_ 


(For example: LET LP.B924930.MYTAB.V3 EQUAL LP.B924930.MYTAB.V1) 


LET allows a new directory name to be generated which points to an already existing table. The only 
attributes which can be changed are the shift codes and the machine restriction. 


SAVE 


—— SAVE AS < filename > 


(For example: SAVE AS MY TRANSFILE 
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SAVE causes a new translation table to be produced from the current workfile. The default file name 
is that associated with the current workfile from an earlier MAKE or GET. The workfile can be saved 
under a different name using the ‘AS <filename>”’ option. 


REMOVE 
REMOVE ———————_4 


(For example: REMOVE) 


REMOVE removes the current workfile, if there is one, and returns the utility to the state which existed 
prior to a GET or MAKE. It is also applicable if a workfile is found, by BUILDTRANS, at BOJ. 


RECOVER 


RECOVER ————————_ 


(For example: RECOVER) 


RECOVER is only permitted at BOJ if BUILDTRANS discovers a file which appears to be an old 


workfile. It attempts to restore the file to the state which existed prior to the abnormai iermination. 


BYE 


BYE ——————__S_ 


(For example: BYE) 
BYE causes BUILDTRANS to go to EOJ. 
BUILDTRANS Message Format 


Message Possible Cause Suggested Action 
<filename> IS NOT A The specified file does not Check input for correct filename. 
VALID TRANSLATION have the filetype of a 
FILE translation file. 

— BREAK COMMAND Normal output after entering None. 

RECEIVED a BRK command. 

—<option> IS NOT A Self-explanatory. Correct input and re-enter. 
VALID OPTION 

—~OPTION HAS ALREADY _ Self-explanatory. None. 

BEEN SPECIFIED 

THE WORKFILE FOR The utility has found a Use RECOVER or REMOVE 
BUILDTRANS CAN BE workfile on disk that can be command. 

RECOVERED, IF recovered. 

REQUIRED 


2 
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Message 


~PLEASE ISSUE A 
RECOVER OR REMOVE 
REQUEST 


-—NO ENTRIES TO LIST 


~ WORKFILE IS 
CURRENTLY BEING USED 
BY ANOTHER PROGRAM 


—LAST OPERATION 
ATTEMPTED WAS 
<command > 


A TRANSLATION FILE 
HAS ALREADY BEEN 
OBTAINED 


— PLEASE ISSUE A SAVE 
OR REMOVE REQUEST 
—- WORKFILE HAS BEEN 
ALTERED 


-NO FILE NAME 
SPECIFIED 


REQUEST IN PROCESS ... 


WORKFILE HAS BEEN 
SUCCESSFULLY 
RECOVERED 


—HARDWARE ERROR 
DETECTED WHILE 
READING FILE 

< filename > 


—<number> IS NOT A 
VALID NUMBER 


-NUMBER EXPECTED 


—<number> IS NOT A 
VALID HEXADECIMAL 
NUMBER 


— <string> IS NOT VALID 
INPUT 


—ONLY ONE DISK NAME 
SHOULD BE SPECIFIED 


—ONLY ONE FILE NAME 
SHOULD BE SPECIFIED 


UNABLE TO RECOVER 
WORKFILE 
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(continued) 
Possible Cause 


Self-explanatory. 


The workfile is empty. 
Self-explanatory. 


Self-explanatory. 


An attempt was made to 
GET or MAKE another 
workfile without saving or 
removing the current one. 


Self-explanatory. 
Self-explanatory. 
Self-explanatory. 
The utility is working on 


your request. 
Self-explanatory. 


The utility has encountered 


a parity error while reading 


the specified file. 
Self-explanatory. 
Self-explanatory. 
Self-explanatory. 
Self-explanatory. 
Self-explanatory. 
Self-explanatory. 


Self-explanatory. 


Suggested Action 
Use RECOVER or REMOVE 
command. 
None. 
Wait until the other program 
stops. 


None. 


Use SAVE or REMOVE first, 
then GET or MAKE the new 
file. 


Correct input and re-enter. 
Wait. 


None. 


Check the integrity of your disk. 


Correct input and re-enter. 
Correct input and re-enter. 
Correct input and re-enter. 
Correct input and re-enter. 
Correct input and re-enter. 
Correct input and re-enter. 


None. 


a 


Message 


~SHIFT CODES MUST BE 
4 CHARACTERS 


UNABLE TO ACCESS 
< filename > 


~A TRANSLATION FILE 
IS REQUIRED 


—NO TABLE NAME 
SPECIFIED 


~TABLE NAME 
<tablename> EXCEEDS 20 
CHARACTERS 


—TABLE <tablename> IS 
ALREADY PRESENT IN 
THIS TRANSLATION FILE 


~TABLE <tablename> IS 
NOT PRESENT IN 
TRANSLATION FILE 

< filename > , 


—NUMBER OF ENTRIES 
LISTED IS <number> 


PLEASE ENTER THE 
REQUIRED TRANSLATION 
MODE 


PLEASE ENTER THE 
REQUIRED ANALYSIS 
MODE 


PLEASE ENTER THE 
REQUIRED HEX SHIFT 
CODES 


PLEASE ENTER THE 
REQUIRED MACHINE 
RESTRICTION 


PLEASE ENTER THE 
MAXIMUM SIZE OF 
TRANSLATION VALUES 


—<tablename> IS A 
SYSTEM TRANSLATION 
TABLE 


FILE <filename> HAS 
NOW BEEN SAVED 
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(continued) 

Possible Cause 
Self-explanatory. 
Self-explanatory. 
Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


An attempt was made to 
build a table with a name 
which already exists in the 
translation file. 


An attempt was made to 
INCLUDE a non-existent 
translation table. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


An attempt was made to 
EDIT or DELETE a 
translation table of type 
system. 


Self-explanatory. 


Suggested Action 


Correct input and re-enter. 


See next message for the reason. 


Use a GET or a MAKE 
command. 


Correct input and re-enter. 


Correct input and re-enier. 


Use another tablename or modify 
the existing table. 


Check input for correct table- 
name and re-enter. 


None. 


Enter 0, 1 or 2. 
Enter a number in the range 0 — 


295s 


Enter two bytes of hexadecimal 
characters. 


Enter up to three different values 
in the range 1-3. 


Enter a value in the range 1 — 
10. 


None. 


None. 
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Message 


—-TABLE <tablename> 
HAS MULTIPLE 
DIRECTORY ENTRIES 


~ NUMBER OF TABLES 
CANNOT EXCEED 
< number > 


—NUMBER OF 
DIRECTORY ENTRIES 
CANNOT EXCEED 
<number > 


~SIZE OF TABLE ENTRY 
CANNOT EXCEED 10 
BYTES 


—TRANSLATION VALUES 
ARE <number> BYTES 


—NUMBER OF 
DIRECTORIES SAVED IS 
<number>, NUMBER OF 
TABLES IS <number> 


—NO TRANSLATION 
VALUES GIVEN 


SYSTRANS Format 


(continued) 
Possible Cause 


An attempt has been made 
to EDIT a table for which 
there are multiple directory 
entries. The EDIT will be 
allowed but the user must 
realise that the table is 
addressed by other directory 
entries. 


A large number of tables is 
generated without requesting 
a save 


See above. 


A table of type mode 1 or 
2 has been discovered, the 
translation value cannot 
exceed 10 bytes. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


Suggested Action 


None. This is only a warning. 


Use a SAVE and then a GET to 
continue the work on the 
specified translation file. 


See above. 


Correct input and re-enter. 


None. 


None. 


Correct input and re-enter. 


SYSTRANS contains translate tables for all versions of the keyboard, screen, line printer and serial 
printer currently supported by the MCP. The user has the capability to specify non-standard translation 
for any of these devices by setting up Sysconfig appropriately and the MCP selects the desired table(s) 
at warmstart. If there is no Sysconfig entry for a device, the MCP selects from SYSTRANS the system 
table supplied for that device. If SYSTRANS is absent at warmstart, all translation remains as it was 
at PO time. Therefore, when the MCP has been set up initially; that is, the first warmstart has been 
completed, SYSTRANS is no longer required unless the operator wishes to alter translation. The user 
who wishes all translation to be based on the keyboard version need do no more than at present in 
order to warmstart — the MCP defaults to the correct translation automatically. 


Each system table has a unique name of the format: 
<device>.< variant >. <country/language>.V< version no. > 
<device> is KB, SP, LP or SC. 


<variant> is used to distinguish different devices with the same device kind; for example, Odec/ 
4 and 3050 line printers. 
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The full list of variants is as follows: 


Device Variants 
KB KB 
SP B 91, B92 
LP B 9249-4, B 9249-30, B 9252 
SC SSi, CRT 


Keyboard versions currently supported are as follows: 


Version No. Country/Language Abbreviations 
0 Arabic(Consoleless) ARBC 
1 United States USA 
2 United Kingdom UK 
3 France FRNCE 
4 Italy ITALY 
5 Germany/Switzerland GRMNY 
6 Brazil/Portugal BRZIL 
7 Spain SPAIN 
8 Denmark/Norway DNMRK 
9 Yugoslavia YGSLA 
10 Sweden/Finland SWDN 
iz Japan(Kawase} JAPAN 
13 Russia RSSIA 
14 Turkey TRKY 
15 Greece GRCE 
16 Iceland ICLND 
18 Sweden/Finland SWDN 
20 Arabic ARBC 
21 Hebrew HBRW 
22 Hangul HNGL 
24 Japan(Katakana) KTKNA 
Examples 

1. Version 1 serial printer on B91 : SP.B91.USA.V1 

2. Version 2 serial printer on B 92 : SP.B92.UK.V2 

3. Version 3 self scan 1 : SC.SS1.FRNCE.V3 

4. Version 4 CRT : SC.CRT.ITALY.V4 

5. Version 5 B 9252 line printer : LP.B9252.GRMNY.V5 

6. Version 6 3050 line printer : LP.B924930.BRZIL. V6 

7. Version 7 ODEC/4 line printer : LP.B92494.SPAIN.V7 

8. Version 8 keyboard : KB.KB.DNMRK. V8 
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CONFIGURER (Configure B 90 System) 


Railroad diagram: 


CONFIGURER LIST PRINT 


CONFIGURER operates on the file SYSCONFIG to be displayed on the screen. 


LIST option: This allows the contents of SYSCONFIG to be displayed on the screen. 
PRINT option: This allows the contents of SYSCONFIG to be displayed on the printer. 


CONFIGURER now operates in one of two possible modes, depending on which one of the two condi- 
tions applies when CONFIGURER is executed. The two conditions are: 


1. SYSCONFIG is present on the system disk and can be opened by CONFIGURER. 
2. SYSCONFIG is not present on the system disk or it cannot be opened by CONFIGURER. 


If SYSCONFIG is present on the system disk and can be opened by CONFIGURER, the user is al- 
lowed to: 


1. Update fields of information that are present in this OLD SYSCONFIG. 
2. Insert new fields of information that are not present in the OLD SYSCONFIG. 


Therefore, when all the updates and insertions have been completed via prompts from CONFIGURER, 
the old SYSCONFIG file is removed and a new SYSCONFIG file is created by CONFIGURER from 
the information supplied, and then “JOB COMPLETED” is displayed. 


NOTE 

Although the CREATING of a NEW SYSCONFIG can be thought of as be- 
ing achieved by UPDATING and INSERTING fields in the OLD SYSCON- 
FIG, in fact, each time CONFIGURER is being executed a completely NEW 
SYSCONFIG file is CREATED. Therefore, any UPDATE or INSERTION 
of a field in SYSCONFIG only exists when all such UPDATES and INSER- 
TIONS have been carried out and CONFIGURER has displayed the message: 
“END CONFIGURER’’. 


If SYSCONFIG is not present on the system disk, cannot be opened by CONFIGURER or is not com- 
patible with this version of CONFIGURER, the user creates a new SYSCONFIG from scratch in the 
following way: 

If a file is to be present in the new SYSCONFIG: 


1. A message, prompting the user to enter information for this field, is displayed. 
2. The user enters the information to be placed in SYSCONFIG. 


Prompts marked with a “‘£”’ only appear when CONFIGURER has opened and old SYSCONFIG and 
the relevant entry is present in SYSCONFIG. 


Any response to prompts marked with “‘U’’ (as far as the utilities are concerned) become effective as 
soon as the relevant utility is executed. These responses will only take effect if CONFIGURER has 
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come to an orderly termination. Responses to prompts which are not marked with a ‘‘U’’ only become 
effective at the next WARMSTART. 


Operating Instructions 


1.0 £ DO YOU WANT TO CHANGE ANY LOGGING OPTIONS? ENTER Y OR 
N 
This asks whether or not items, in the 
logging of system messages are to be updated. For an explanation of foaving 
in 3.05, see section 4 under LOGGING IN THE 3.05 RELEASE. Valid 


responses are: ‘‘Y’’ (yes) or ‘‘N’’ (no). If the response is ‘“‘N’’, go to 2.0. 


SPO LOGGING IS SWITCHED ON 
or 
SPO LOGGING IS SWITCHED OFF 


1.1.1 £ DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘“‘N’’ and SPO logging is switched on go to 1.2. If ‘‘N’’ 
and SPO logging is switched off go to 1.3 
1.1.2 £ IS LOGGING OF SPO MESSAGES REQUIRED? ENTER Y OR N 
This asks whether or not logging of system messages is required at the next 
warmstart (‘‘Y’’ is advisable). If the response is ‘“‘N’’ go to 1.3 
1.2 £. LOGGING OF SYSTEM MESSAGES IS CYCLIC 
or 
LOGGING OF SYSTEM MESSAGES IS NON-CYCLIC 
depending on the current form that system messages are to be logged in. 


—_ 
— 
th 


1.2.1 £ DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘‘N’’ go to 1.3 
1.2.2 £ DO YOU WANT LOGGING OF SYSTEM MESSAGES TO BE CYCLIC? 


ENTER Y OR N 
This asks whether system messages are to be logged in CYCLIC or NON- 
CYCLIC form. Valid responses are: ‘“‘Y’? for CYCLIC or ‘‘N”’ for NON- 


CYCLIC. 
1.3 £ CURRENT SIZE OF PRIMARY LOG FILES IS <integer> SECTORS 
where <integer> = the size, in sectors, of the four primary log files. 
1.3.3 £ DO YOU WANT TO CHANGE IT? Y OR N 


If the response is ‘‘N’’ and SPO logging is switched on, go to 1.4. If ‘‘N”’ 
and SPO logging is switched off go to 1.5. 


1.3.2 £ ENTER SIZE OF PRIMARY LOG FILES IN SECTORS 
— MINIMUM IS 32, MAXIMUM IS 16383 
This requests the size, in sectors, of the four primary log files. A valid 
response is an <integer> in the range 32 to 16383. 


1.4 £ CURRENT SIZE OF SECONDARY SYSTEM MESSAGE FILE(S) IS 
<integer> SECTORS 

1.4.1 £ DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘‘N’’ go to 1.5. 

1.4.2 ENTER THE SIZE OF SECONDARY SYSTEM MESSAGE BEC}! IN 


SECTORS — MINIMUM IS 32, MAXIMUM IS 262140 
A valid response is an <integer> in the range 32 to 262140. 
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1.5 £ CURRENT SIZE OF SECONDARY SYSTEM MAINTENANCE ENTRY 
FILE(S) IS <integer> SECTORS 

1.5.1 £ DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘‘N’’ go to 1.6. 

1.5.2 ENTER SIZE OF SECONDARY SYSTEM MAINTENANCE ENTRY FILE(S) 


IN SECTORS — MINIMUM IS 32, MAXIMUM IS 262140 
A valid response is an <integer> in the range 32 to 262140. 


1.6 £ CURRENT BACKUP DISK FOR LOG FILES IS <disk-id> 
or 
CURRENT BACKUP DISK FOR LOG FILES IS SYSTEM DISK 
depending on whether backup log files are to reside on the disk named <disk- 
id> or on the system disk. 


1.6.1 £ DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘‘N’’ go to 2.0. 
1.6.2 ENTER ID OF BACKUP DISK FOR LOG FILES 


This requests the identifier of the disk that backup log files are to reside on. 

Valid responses are: 

i) a <disk-id> 

2) <blank>, in which case backup log files will reside on the system disk. 
2.0 £ CURRENT TEXT TO BE ZIPPED AT WARMSTART IS x 

(where “‘x’’ is the text to be zipped at the next warmstart) 


or 
NO TEXT WILL BE ZIPPED AT WARMSTART 


2.1 £ DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘‘N’’ go to 3.0. 
22 ENTER TEXT TO BE ZIPPED AT WARMSTART 


This requests the text to be zipped at the next warmstart. No checking is 
performed on the text entered. However, only the first 255 characters of the 
text entered are zipped. 


3.0 £ CURRENT POWER OFF MESSAGE IS x ; 
(where ‘‘x”’ is the message to be displayed when a session is terminating) 
or 
THERE IS NO POWER OFF MESSAGE 


3.1 £ DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘‘N’’ go to 4.0. 
32 £ ENTER POWER OFF MESSAGE 


This requests the text of the message to be displayed when a session is 
terminating. The text must not be more than 80 characters in length. 


4.0 £ CURRENT LANGUAGE DICTIONARY FILENAME IS <file-name> 
where <file-name> is the name of the current local language message file. 
4.1 £ DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘‘N’’ go to 5.0. 
4.2 U ENTER FILE NAME OF REQUIRED MESSAGE FILE 


This requests the <file-id> of the required local language message file. Valid 
responses are: 

1) a <file-id> 

2) <blank>, in which case the message file will be ‘““SYSLANGUAGE”’. 
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6.0 


6.1 


6.1.2 
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DO YOU WANT TO CHANGE ANY PRINTER BACKUP OPTIONS? 
ENTER Y OR N 

This asks whether or not items in the SYSCONFIG file concerned with printer 
backup files are to be updated. If response is “N’’? go to 6.0. 

CURRENT PRINTER BACKUP FILE SIZE IS <integer> RECORD(S) 
where <integer> is the maximum size, in records, of a printer backup file. 
DO YOU WANT TO CHANGE IT? Y OR N 

If the response is ‘‘N’’ go to 5.2. 

ENTER PRINTER BACKUP FILE SIZE IN RECORDS — MINIMUM IS 1, 
MAXIMUM is 999999. 

This requests the maximum size, in records, of printer backup files. A valid 
response is an <integer> in the range 1 to 999999. 


PRINTER FILES ARE SENT TO BACKUP 


or 
PRINTER FILES ARE NOT SENT TO BACKUP 


DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘‘N’’ go to 5.3. 


DO YOU WANT PRINTER FILES TO GO TO BACKUP? ENTER Y OR N 
This requests whether or not printer files are to go to backup. 

CURRENT PRINTER BACKUP DESIGNATE Dion 15 eeskname> 

or 

CURRENT PRINTER BACKUP DESIGNATE DISK IS SYSTEM DISK 
depending on whether printer backup files are to reside on the disk named 
<disk-name> or on the system disk. 


DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘‘N’”’ go to 6.0. 


ENTER NAME OF PRINTER BACKUP DESIGNATE DISK 

This requests the disk that the printer backup files are to reside on. Valid 
responses are: 

1) a <disk-name> 

2) <blank>, in which case printer backup files reside on the system disk. 
DO YOU WANT TO CHANGE ANY SPO OPTIONS? ENTER Y OR N 
This asks whether or not items in the SYSCONFIG file concerned with the 
local SPO and the remote SPO are to be updated. If the response is ‘‘N’’ go 
to 7.0. 

DOES THE SYSTEM HAVE A LOCAL SPO? ENTER Y OR N 

This asks whether or not a local SPO will be present at the next warmstart. 
If the response is ‘‘N’’ go to 6.2. 


LOCAL SPO IS SCA 
or 
LOCAL SPO IS SPA 


depending on whether the local SPO is a screen (SCA) or a serial printer 
(SPA). 


DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘‘N’’ go to 6.2. 


8-83 


a 


6.1.3 ENTER LOCAL SPO OPTION, EITHER SCA OR SPA 
This asks whether the local SPO is a screen (SCA) or a serial printer (SPA). 
NOTE If the user’s choice is not applicable to the machine’s configuration, 
the final choice of the type of local SPO will be determined by the MCP at 
warmstart. 


6.2 £ THE SYSTEM HAS A REMOTE SPO 
or 
THE SYSTEM DOES NOT HAVE A REMOTE SPO 
depending on whether or not a remote SPO will be present at the next 
warmstart. 


6.2.1 £ DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘‘N’’ and the system has a remote SPO go to 6.3. If ‘“‘N” 
and the system does not have a remote SPO go to 7.0. 


6.2.2 DOES THE SYSTEM HAVE A REMOTE SPO? ENTER Y OR N 
6.3 £ CURRENT REMOTE SPO MCS IS x 
where ‘‘x’’ is the <file-id> and initiating message of the remote SPO’s MCS. 
6.3.1 £ DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘‘N’’ go to 7.0. 
6.3.2 £ ENTER FILENAME AND INITIATING MESSAGE OF REMOTE SPO MCS 


This requests the MCS of the remote SPO. 

Valid responses are: 1) a <file-id> followed by the initiating message. No 
checking is performed on the initiating message. The length of the <file-id> 
plus initiating message must not be greater than 40 characters. 

2) <blank>, in which case the MCS and initiating message will be ‘‘MCSOBJ 
DC CC’’. 


7.0 £ DO YOU WANT TO CHANGE ANY TRANSLATION FILES? ENTER Y 
OR N 
This asks whether or not the current set of translation tables is to be updated. 
See BUILDTRANS utility for details about translation. If the response is ‘‘N’’ 


go to 8.0. 
7A £ CURRENT NUMBER OF TRANSLATION TABLES IS <integer> 
7.1.1 £ DO YOU WANT TO CHANGE IT? Y OR N 


If the response is ‘‘N’’ and <integer> is greater than zero go to 7.2. If ‘‘N” 
and <integer> equal to zero go to 8.0. 


7.1.2 ENTER NUMBER OF TRANSLATION TABLES — MAXIMUM JIS 255 
A valid response is an <integer> not greater than 255. 
7.2 TABLE NUMBER <integer> 


where <integer> is the number of the translation table that is currently being 
updated or inserted. If the set of translation tables is to be updated, this is 
displayed for all translation tables in the new SYSCONFIG file. 


7.2.1 £ CURRENT DEVICE KIND AND NUMBER IS abn 
“‘ab”’ is the CMS DEVICE MNEMONIC and “‘n’’ is the DEVICE NUMBER 
of a translation table. 


7.2.2 £ DO YOU WANT TO CHANGE IT? Y OR N 
If the response is ‘‘N” go to 7.3. 
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ENTER DEVICE KIND AND NUMBER 


This requests a CMS DEVICE KIND and a DEVICE NUMBER for a 
translation table. A valid response is abn, where: 
‘tab’? is one of the CMS DEVICE MNEMONICs ‘‘SP’’, ‘“‘LP’’. ‘‘SC’’ or 


‘‘n’? is a DEVICE NUMBER so that “A”? < n s “Z”’. 


CURRENT TRANSLATOR NAME IS <identifier > 


DO YOU WANT TO CHANGE IT? Y OR N 


If the response is ‘‘N’’ and there are more tables to be completed, go to 7.2. 
If ‘‘N’’ and all tables have been completed go to 8.0. 


12.3 
**KB’’ and 
7.3 £ 
7.3.1 £ 
Edd 


ENTER NAME OF TRANSLATOR 


A valid response is an <identifier> of not more than 20 characters. 
If there are more tables to be completed, go to 7.2. 


8.0 END CONFIGURER 
This is the normal job terminating message. The utility has now released the 
file under the name ‘‘SSYSCONFIG”’ onto the system disk. 


Output Messages 


Message 


INVALID SELECTION, 
PLEASE RETRY 


<faulty input> IS NOT A 
VALID FILESIZE 


INVALID CHARACTER IN 
< identifier > 


<faulty input> IS NOT A 
VALID DISK NAME 


<faulty input> IS NOT A 
VALID FILE NAME 


TEXT LENGTH EXCEEDS 
UTILITY LIMIT 


<faulty input> IS NOT A 
VALID INPUT FOR THE 
NUMBER OF 
TRANSLATION TABLES 


HARDWARE ERROR 
DETECTED WHILE 
WRITING TO FILE <file- 
name > 
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Possible Cause 


Self explanatory. Request is 
repeated. 


The value for the filesize is 
illegal. Request is repeated. 


<identifier> has invalid 
character(s) in it. Request is 
repeated. 


Probably the disk name 
contains more than seven 
characters. Request is 
repeated. 


Probably the file name 
contains more than 12 
characters. Request is 


repeated. 


Text contains more than 80 
characters. Request is 
repeated. 


The value for the number of 
translation tables is illegal. 
Request is repeated. 


A parity error was 
encountered while writing to 
the specified file. The utility 
terminates and no new 
SYSCOMFIG file is created. 


Suggested Action 


Use a valid response, see 
request. 


use a valid response, see 
request. 


Valid characters are A-Z, 0-9, . 
(dot) — (dash). 


Check input then re-enter a 
valid disk name. 


Check input then re-enter a 
valid file name. 


Re-enter text cut down to 80 
characters or less. 


Enter an integer in the range 0- 
255; 
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Message 


HARDWARE ERROR 
DETECTED WHILE 
READING FILE <file- 
name> 


(continued) 
Possible Cause 


A parity error was 
encountered while reading 
from the specified file. The 
utility terminates and no new 
SYSCOMNFIG file is created. 


Suggested Action 


GEN.DUMPFL (Create Empty B 90 Memory Dump File) 


The function of the GEN.DUMPFL utility is to create, on a disk specified by the user, a single-area 
file to which the contents of memory can be dumped. The name and size of the file can be specified 
by the user. As a check against bad sectors, the utility writes a repetitive pattern of ASCII ‘‘A”’ 
through ‘‘L’’ to each record of the created file. 


Railroad diagram: 


< number > ————————- ON < disk-name > AS < filename > 
GEN.DUMPFL Pc (iSeries | { 


where: 

size specifies the file size in K bytes. If specified, it must be an integer in the 
range 64 to 11492; if not specified, the default value 1024 is assumed (1024 K 
bytes being sufficient to contain 8 pages of memory). 

disk-name if not specified, the system disk is assumed. 

file-name if not specified, a file named MEMDUMP is created. Note that memory can 


only be dumped (by the CMS bootstrap WARMBOOT) to disk files named 
MEMDUMP. So, if any other file-name is specified, the file-name must be 
changed to MEMDUMP before memory can be dumped to it successfully. 


If it is intended to dump memory to a fixed disk, the size of the file created on that disk by GEN- 
.DUMPFL must be large enough to hold all of memory. 


If it is intended to dump memory to removable disks, the size of the file created on a removable disk 
by GEN.DUMPFL need not be large enough to hold all of memory as the Dump Memory to Disk 
function of CMS bootstrap WARMBOOT can dump to a sequence of removabie disks containing 
MEMDUMP files. 


When one single-area file has been created on a disk, the user is informed by the following message: 


‘“—DUMPFILE <file-name> CREATED ON <disk-name> 
EARLIER DUMPFILES OF SAME NAME ARE REMOVED” 


If the size of the file created on a removable disk is smaller than the file size requested, the user is 
informed by the following message: 


‘MORE DISK SPACE IS REQUIRED 
LOAD ANOTHER — NOT THE SAME — DISK 
ENTER ITS NAME” 


The utility will wait for the user to ready another removable disk and enter its name. It will then create 
a file with the name originally specified by the user. The size of this file will be the difference between 
the size originally requested and the size of the first file created, or the size of the largest area available 
on the disk, whichever is smaller. Requests for more disk space will continue to be made until the 
sum of the size of the files created is equal to the size originally requested. 


NOTES: 


1. An area of at least 256 sectors must be available on a disk before GEN.DUMPFL will attempt 
to create a dump file. If no such area exists, the following message will be displayed: 
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“INSUFFICIENT DISK SPACE TO CREATE MEMORY DUMP FILE” 
The user must then remove files from the disk or load another disk. 

2. A sequence of removable disks may include cartridge and/or floppy disks. However, it is rec- 
ommended that the types are not mixed. A sequence of removable disks may include Caelus, 


SDI or Winchester disks, although it is recommended that the types are not mixed. 


3. When dumping memory to a sequence of removable disks, disks need not be loaded in the same 
order as they were submitted to GEN.DUMPEL. 


When the total file size created, on a single disk or on a sequence of removable disks, is equal to 
the size requested by the user, the following message is displayed before GEN.DUMPFL goes to EOJ: 


“ALL SPACE REQUESTED HAS BEEN RESERVED’’ 
Examples: 


To create a file named MEMDUMP on the system disk with a size of 1024 K bytes of memory, 
enter: 


GEN.DUMPFL 
To create a file named DUMP.FILE on disk ABC with a size of 80 K bytes of memory, enter: 
GEN.DUMPFL 80 ON ABC AS DUMP.FILE 
Output Messages 


Message Possible Cause Suggested Action 

SIZE TOO SMALL Size requested less than 64 Re-input. 

SIZE TOO LARGE Size requested greater than Re-input. 
11492 

DISK NAME TOO LARGE Disk name greater than Re-input. 
seven characters. 

FILE NAME TOO LONG File name greater than 12 Re-input. 
characters. 

DISK NOT FOUND Incorrect disk name entered. Re-input. 

INVALID DISK NAME Incorrect disk name entered. Re-input. 
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INSTALL (Disk File Cony From System to Fixed Disk) 


The INSTALL utility provides a simple method of copying all necessary system files from a mini or 
cartridge bootstrap system disk to any disk, except 1 Mb and 3 Mb disks. This is achieved by having 
the INSTALL utility resident on the Bootstrap disk. When INSTALL is executed, it copies the contents 
of the Bootstrap system disk, except the utility itself, to the named disk, including those files which 
cannot normally be copied because of ‘““OTHERUSE”’ restrictions on the COPY utility FREE and 


SHARED options. 


Railroad Diagram: 
INSTALL —————— < disk-name > — 


<disk name> is the name of the disk to which files are to be copied. 


The utility does not support the star-file feature * <file-name >. When complete, the operator can pow- 
er off and warmstart the ‘‘installed’’ fixed disk. 


The following conditions must be true for the INSTALL utility to function: 


. There is a suitable mix Gf not, INSTALL will not be loaded). 
. The executing system is a B 90. 
. The INSTALL utility is resident on the system disk. 
. The system disk is a Burroughs Mini disk. 
. The named output disk is not a Burroughs Mini disk. 
NOTE 


A suitable mix occurs when no user programs, utilities or intrinsics are run- 
ning. 


UMP WN 


If any of the conditions 2-5 do not apply, an error message is displayed and the utility terminates. 
(See Output Messages.) 


Providing conditions 1-5 are satisfied, and the specified output disk is on line, the utility copies the 
contents of the Bootstrap disk to the named disk. The utility does not copy itself. 


As each file is copied, the following message is displayed: 
<file-name> COPIED 


If a file cannot be copied for any reason, an error message is displayed. (see Output Messages). IN- 
STALL will not copy keyfiles. 


NOTE 
If a keyfile is found on the Bootstrap disk, a warning message is displayed. 


If a file with the same file-name exists on the output disk, the duplicate file will be removed from 
the output disk if the filetype is the same as the file being copied. If the filetypes are different, the 
user is prompted by the MCP to change the name or to remove the duplicate file on the output disk. 
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Output Messages - 


Message 


<file-name> COPIED TO 
< file-name > 


<file-name> REMOVED 


PLEASE POWER OFF THE 
SYSTEM DISK AND 
REWARMSTART FROM 

< disk-id > 


<file-name> NOT COPIED 
— FILE IS A KEYFILE 


—- CANNOT ALLOCATE 
THIS FILE ON DISK 
<output disk-id> 


HARDWARE ERROR 


DETECTED WHILE 
READING FILE 


HARDWARE ERROR 
DETECTED WHILE 
WRITING TO DISK 
<output disk-id> 


THE FOLLOWING 
<integer> FILES WERE 
NOT COPIED — <file-name 
list > 


PLEASE USE ‘“‘COPY” TO 
COPY THESE FILES, 
FROM ANOTHER DISK IF 
NECESSARY 


BEFORE POWERING OFF 
DISK <system disk-id > 
AND WARMSTARTING 
FROM DISK <disk-id> 


— THIS SYSTEM IS NOT 
A B90 


THIS PROGRAM MUST BE 
EXECUTED FROM THE 
SYSTEM DISK 


— SYSTEM DISK <disk- 
id> NOT A MINI OR 
CARTRIDGE DISK 


~ SYSTEM DISK <disk- 
id> CANNOT BE 
ACCESSED 
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Possible Causes 
Successful copy. 


Self-explanatory. 


All files have been 
successfully copied. 


Self-explanatory. 
Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


One or more files could not 
be copied by the utility. 


INSTALL can only be run 
on a B 90 system. 


INSTALL must reside on 
the system disk. 


Self-explanatory. 


Self-explanatory. 


Suggested Action 
None. 


None. 
None. 


See second message given for 
explanation. 


Remove keyfile from Bootstrap 
disk. 


None. 


Use another disk. 


See second message given for 
explanation. 


See second message given for 
explanation. 


See second message given for 
explanation. 


None. 


Copy the INSTALL utility onto 
the system disk and re-run. 


Use the correct type of disk and 
re-run the utility. 


System disk may not be on line. 


Message 


— DISK <output disk-id> 
IS A MINI DISK 


— DISK <output disk-id> 
IS CURRENTLY LOCKED 
BY ANOTHER PROGRAM 


UNABLE TO CONTINUE 
WITH INSTALL 


— DISK <output disk-id> 
IS FULL, PLEASE 
REFORMAT FOR LARGER 
NUMBER OF FILES 


— HARDWARE ERROR 
DETECTED ON 
DIRECTORY OF DISK 
< disk-id > 


- DISK <output disk-id> 
IS CURRENTLY LOCKED 
BY ANOTHER PROGRAM 


— DISK <output disk-id> 
IS NOT ON LINE 
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(continued) 
Possible Causes 


The output disk is an 
invalid mini disk for 
example, 1 Mb or 3 Mb 
mini. 

The output disk is currently 


being used by another 
program. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


Suggested Action 


Remove the disk and use one of 
the following types: 

211 fixed disk 

2011 fixed disk 

cartridge 

Wait until other program has 
finished and re-submit. 


See second error message given 
for explanation. 


Reformat disk using DSKUTL. 


Use another disk. 


Wait until other program has 
finished using disk and then 
retry. 


Insert and/or make ready output 
disk 
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PATCHMAKER | 
(Patching B 90 Machine-Code Object Program Files) 


This utility gets the patches from either the SPO via displays and accepts or from a disk file. The 
patches are then made to the relevant code file. Stringent conditions are enforced to make the patch, 
including the necessity to apply each patch in the correct order. Each line of patch data contains an 
extra byte which is used as a checksum for that line. If a line of data is incorrectly entered, the 
operator is prompted to re-enter that line — this does not invalidate previously entered lines of data. 
An overall checksum is also included to verify the entire patch. All previous patches must be applied 
before the next patch. 


In order to achieve continuity of system code-file names, the following naming convention will be used: 


For B 90 MCP MCPXn.nn.nn 
For B 90 BILINTERP BILXn.nn.nn 

For B 90 COBOLINT COBXn.nn.nn 
For B 90 SORTINTRINSIC SINT Xn.nn.an 
For B 90 NDLINTERP NDLXn.nn.nn 
For B 90 MICROPOL MICXn.nn.nn 
For B 90 SAU SAUn.nn.nn 


where n.nn.nn is the software mark, release and patch level (for example, MCPX3.04.09). 


It is essential that an unused copy of all micro-coded software items is retained for patching. It is not 
possible to patch a B 90 MCP that has been used in normal B 90 operations. This is because certain 
MCP tables included in the code file are modified during operation. This modification would cause 
the check digit calculations in PATCHMAKER to fail. Use either the Stand-Alone Utility (SAU) COPY 
function, MCP COPY or LD utilities to create unused copies of all system software for patching pur- 
poses, and also to create backup copies of patched software. All files which PATCHMAKER requires 
must reside on disk. 


PATCHMAKER is executed via an initiating message which contains all the information concerning 
the mode of entry of the patches (displays and accepts or patch file) and the names and locations of 
the files involved. The initiating message for PATCHMAKER is as follows: 


< patched-file-name > ——-——> 


TO 


PATCHMAKER ————— < file-name-to-be-patched > 


< patches-file-name > 


Where <file-name-to-be-patched>, <patched-file-name> and <patches-file-name> are defined as: 


< disk-name > / < file-name > — 
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< file-name-to-be-patched > This is the name of the file that is to have the 
patches applied to it. 


< patched-file-name > This is the name which will be given to the 
patched file, if the patching has been successful. 
DISK if the keyword DiSK is specified, PATCHMAKER 


will look for a file from which to extract the 
patches. If no <patches-file-name> is specified, 
PATCHMAKER will expect to find a file called 
‘“‘PATCHES”’ on the system disk. In either case, 
the file must have been created by PATCHMAKER 
(see note following) or the appropriate internal 
Burroughs program. 


NOTE 
PATCHMAKER has no option to create a patch file. The utility will create 
a patch file if, after patches have been entered via accepts, a fatal error oc- 
curred or the operator terminated execution after a non-fatal error. The patch 
file created under these circumstances should never be applied to a code file, 
as the result may be incorrect. 


If the keyword DISK does not appear in the initiating message, the entry of patches will be by displays 
and accepts via the SPO. The utility will display: 


ENTER PATCHES NOW 
The patches must now be entered by accepts, via the SPO when prompted, from the hardcopy pro- 
vided. The characters must be entered exactly as supplied, although spaces are not significant and may 


be entered as found convenient. The utility will ask for resubmission of lines which are incorrect. 


When the utility has correctly applied the patches, the following message will be displayed before 
PATCHMAKER terminates: 


PATCHES TO <file-name> HAVE BEEN SUCCESSFULLY APPLIED AND SAVED AS FILE 
<file-name>. 


Patching Procedure 


A sample B 90 CMS System Software Flash is shown in the following paragraphs. 


Sample Flash 


B 90 CMS System Flash No. 3.04-xx. 
SUBJECT: B90 MCP VERSION 3.04.04 
PROBLEM: The FUNCTION F can result in................ 
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TEMPORARY FIX: 


Follow the instructions for PATCHMAKER found in section 8 of the Series 
B 90/B 900/CP 9500, B 1800/B 1900 Computer Management Systems (CMS) 
System Software Operation Guide, Form No 2032801. 


The sub-title of the relevant procedure is ‘“PATCHING IMPLEMENTATION”’ 


MCPX3.04.04 
MCPX3.04.05 


3030 3030 3030 304D 4350 D9 
5833.  2E30 332E 3037 2000 E4 
0000 OOBS 3D6F C12C 0132 32 
3820 38C4 

0332 3837 «=2033 «3020: «=2IC7F SO OF6 
3120 OASA O01C 0216 3BOF E2 
197A 


C47A * (ASTERISK) 
NOTE: The character * must be entered. The word ASTERISK is included 
for clarification only. 


MCPX 


WARNING 


This is not a live patch. It is shown only to illustrate the new patching proce- 


The following procedure is designed to make patching easier for the user to understand and implement. 
The format for each patch, issued in a CMS Flash, will conform to the sample Flash shown previously. 


System Flashes which involve patches to system software will consist of a number of ‘‘labelled inserts’’ 
(A through E) where: 


A czas 


B ... 
Cas 
D 
E 


Is the file name of the file to be patched. 

Is the file name to be given to the patched file. 
Is the actual patch. 

Is the patch checksum with terminating character. 


Is the executing name of the file just patched. 


The instructions contained in the following procedure contain ‘‘labelled blanks’’ (A through E). When 
applying a patch using this procedure, the ‘‘labelled blanks’’ are replaced with the text of the corre- 
sponding ‘‘labelled inserts’? of the Flash. 
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Operating Instructions 


Before executing the program PATCHMAKER, perform steps 1 and 2. 


3. 


. Ensure that the program PATCHMAKER is resident on the system disk. 
. Copy an unexecuted version of the file < A > to either the system disk or user disk. This 


is the file to be patched. SAU COPY, CMS COPY or CMS LD may be used to copy the file. 
Execute PATCHMAKER with the following initiating message 


PATCHMAKER < disk-name A> / <A>—— TO [ < disk-name B > / am <B> —_ 


Where: 
<disk-nameA> is the name of the disk where file < A > resides. 
<disk-nameB> is the name of the disk on which file < B > is to be saved. 


The system displays: 
“ENTER PATCHES NOW” 
““<mix number >/PATCHMAKER ACPT”’ 


4. Enter ‘‘AX <mix number> space’? < C > for each line of the flash as supplied. 


3% 


If entering the patch through a console SPO (SELF-SCAN, CRT or Printer), terminate each 
line hy nreccing OCK!1 
J 


line by pressing OCK]). 
If entering the patch through a data comm SPO, terminate each line with the transmit (XMT) 
key. 


The spaces contained in < C > can be entered. This makes the data easier to read from 
the flash and to enter via the keyboard. These spaces are ignored by PATCHMAKER. 


“FRROR IN LAST LINE ENTERED — RESUBMIT”’ 
“*< mix number >/PATCHMAKER ACPT”’ 
Check the content of the last line entered and re-enter the data correctly. 
When all the lines of < C > have been entered correctly, enter ‘‘AX <mix number> space’’ 
< D>. 
Ensure that the last character entered on this line is the character * (asterisk or star). This 
character informs PATCHMAKER that this is the last entry and is the overall checksum for 
the patch. 


For non-English keyboards, this is the key which produces the ASCII code @2A@. 
The utility will then display: 


PATCHES TO <disk-nameA>/< A > HAVE BEEN SUCCESSFULLY APPLIED, AND 
SAVED AS FILE <disk-nameB>/< B > 


and PATCHMAKER will go to End Of Job. 


The procedure for installing the patched software is dependent on the backup medium used on the 
system. If the backup medium used on the system is disk, follow steps D1 through D6. Otherwise, 
follow steps Tl through T7 for systems which use tape as the backup medium. 
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D1. 


D2. 
D3. 


D4. 


D5. 


D6. 


Logically PO the disk containing < B > and if it is a removeable disk, write disable 
on it. 

Load Stand Alone Utilities (SAU). 

Using SAU RM, remove < A > and < E > from each disk in your library (including 
your system disk). Copy the file < B > to all of the disks which contained < A > or 
< E>. 

Retain a copy of < B >, which must never be executed in order that future patches 
can be applied if necessary. The patch implementation is now complete for your library 
files. 

On the system disk, using SAU CH, enter 

CH <system-disk-name>/< B > TO <system-disk-name>/<E> 

Enter ‘“WS’’ 


The system can now be warmstarted and will be fully operational with the newly 
patched software. 


For systems which use tape as backup medium, the procedure is similar except that the CMS tape 
utilities (SYCOPY, LD, COPY) are used. 


Ti: 
T2. 
T3. 
T4. 
TS. 


T6. 


T7. 


Follow your normal library updating procedures to replace < A > with < B >. 
Copy < B > to the system disk. 

Logically PO the system disk. 

Load Stand Alone Utilities (SAU). 


Using SAU RM, enter 
RM <system-disk-name>/< E > 


Using SAU CH, enter 
CH <system-disk-name>/< B > TO <system-disk-name>/< E > 


Enter ‘‘WS’’. 


The system can now be warmstarted and will be fully operational with the newly 
patched software. 


Patchmaker Error Messages 


The following error messages are produced for a bad initiating message. Check the initiating message, 
and re-enter corrected message. 


Oe 
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INCOMPLETE INITIATING MESSAGE 

UNEXPECTED PARAMETER <offending symbol> IN INITIATING MESSAGE. 
UNEXPECTED CHARACTER <character> IN INITIATING MESSAGE. 
KEYWORD —- TO — MISSING FROM INITIATING MESSAGE. 

DISK NAME <disk-name> IN INITIATING MESSAGE TOO LONG. 

FILE NAME <file-name> IN INITIATING MESSAGE TOO LONG. 


ENTER PATCHES NOW. 
Prompts the user to begin entering the patches. 


The following error messages are produced if an error is detected when entering patches via the SPO. 


8. 


10. 


il. 


ERROR IN LAST LINE ENTERED — RESUBMIT 

The line just entered, checksum has failed. Check the line for errors and re-enter. 
ERROR IN PATCHES ENTERED — RUN ABORTED 

The overall checksum for the patches entered has failed. Check the input to 
PATCHMAKER, then restart patch procedure. 


PATCHES HAVE BEEN ENTERED CORRECTLY. 
Dispiayed subsequent to correct SPO input of patches. 


PATCHES ARE FOR FILE <file-name> NOT <file-name>. 


The file name entered, in the initiating message for the file to be patched, is different to 
the file name embedded in the patches. Check the input to PATCHMAKER, then restart 
patch procedure. 


The following error messages inform the operator of an error condition and ask the operator to take 
corrective action. The following prompt is displayed in addition to the error and correction messages. 


ENTER C TO CONTINUE, S TO STOP 


If the operator is able to correct the error, ‘‘C’’ should be AXed. This will cause PATCHMAKER 
to repeat the checks and continue. 


If for some reason the operator does not wish to continue, ‘‘S’’ should be AXed. If the patches were 
entered via accepts and displays, the file ‘“‘PATCHES”’ is saved and the message: 


FILE PATCHES SAVED 


is displayed. The utility will stop. 


If a response other than ‘‘C’’ or ‘‘S’’ is given to the prompt above, the following error message is 
displayed: 


RESPONSE MUST BE C TO CONTINUE, S TO STOP 


At this point ‘‘C’’ or ‘‘S’’? must be AX’ed to PATCHMAKER. 


12. 


13. 
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FILE <file-name> FOR PATCHING IS ABSENT. 
PLEASE MAKE <file-name> AVAILABLE. 


The file named for patching is not present on the disk specified. To continue, copy the 
required file to <file-name>. Then AX ‘‘C’? to PATCHMAKER. 


To stop the utility, AX ‘‘S’? to PATCHMAKER. 


INITIAL CHECKSUM DISCREPANCY FOR FILE <file-name>. 
PLEASE MAKE CORRECT FILE AVAILABLE AS <file-name>. 


The file on the system with <file-name> is either corrupt or the wrong file. 
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To continue, ‘copy a good version of the correct file to <file-name>, then AX ‘‘C’’ to 
-PATCHMAKER. 


To stop the utility, AX ‘‘S’? to PATCHMAKER. 


14. <fileename> IS NOT A FIRMWARE FILE. 
PLEASE MAKE CORRECT FILE AVAILABLE AS <file-name>. 


The file on the system with <file-name> is not the correct type of file to be patched. 
To continue, copy the correct file to <file-name>. Then AX ‘‘C’? to PATCHMAKER. 


To stop the utility, AX ‘‘S’? to PATCHMAKER. 


15. DATE OF <file-name> CONFLICTS WITH PATCH DATE 
PLEASE MAKE CORRECT FILE AVAILABLE AS <file-name> 


16. DISK <disk-name> IS NOT AVAILABLE. 
PLEASE MAKE DISK <disk-name> AVAILABLE. 


The disk <disk name> is not on the system. 
To continue, load the disk called <disk name> or ready it using RY if it is not ready. 
Then AX ‘‘C’? to PATCHMAKER. 


To stop the utility, AX ‘‘S’? to PATCHMAKER. 


The following error messages inform the operator of errors encountered during patching. PATCH- 
MAKER will terminate. 


If the patches were entered via displays and accepts, the patches will be saved in a file on the system 
disk called ‘‘PATCHES’’. This allows PATCHMAKER to be re-run with the option DISK, meaning 
the operator does not have to input the patches again. The following message will be displayed to in- 
form the operator that this has been done: 


17. FILE PATCHES SAVED 

18. ERROR ON READING RECORD <record-number> OF FILE <file-name> 
A read error has been detected when reading from the file <file-ename> which was 
being patched. Re-run PATCHMAKER with a good version of the file to be patched. 


The following messages are caused by errors encountered during patching. They may be caused by tam- 
pering with the file ‘‘“PATCHES?’’. 
19. PATCHING ERROR — PATCH TOO LARGE FOR <file-name> 
Request technical assistance. 
20. PATCHING ERROR — CANNOT FIND RECORD IN <file-name> FOR PATCH. 
Request technical assistance. 


21. PATCHING ERROR — TERMINATING CHECKSUM FOR <file-name> 
INCORRECT AS <file-name> 


This is displayed after a successful PATCHMAKER run. 
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PMB90 (Analyze B 90 Memory Dumps) 


This utility is an interactive program which produces a formatted print of the contents of a memory 
dump tape or disk file produced by the memory dump feature of the B 90 bootstrap ROM. The tape 
must be labelled ‘““MEMDUMP/MEMORY” or the disk file must be named MEMDUMP on the sys- 
tem disk unless otherwise specified to PMB90. Neither MEMDUMP file-name nor disk-name may start 
with a number. 


The utility requires the following files on the system disk. These are unchanged from earlier releases: 


PMB90 — object code file 

PMBHELP — data file of prompt messages 
PMBERROR — data file or error messages 
PMBM.xxxxx — data file for information on MCP xxxxx 
PMBO.xxxxx — data file for information on MCP xxxxx 


The x values vary with each release: the files provided with each release must be used with that release, 
otherwise incorrect analysis may be made. The utility checks version numbers of its data files and issues 
a warning if they are not the same as the PMB90 version. All data files include version numbers. 


Starting The Utility 


The utility can be executed with a number of options in the initial message. The format is as follows: 


ON 


PMB90 < filename > < diskname > 
ON TAPE 


MERGE 


The meaning of these options is as described in the following paragraphs. 


AX 


Memory dump analyser will issue an accept when input is required from the operator. AX is ignored 
if PMB90 is initiated via datacomm. 


GET <filename> 
This option informs PMB90 that it should search for a memory dump file on the system disk (or on 
the disk specified in the ON option) with the name specified in <filename>. If the filename option 


is not used, PMB90 will search for a file called MEMDUMP. will search for a file called MEMDUMP. 
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If PMB90 is initiated through datacomm and no GET option is used, the utility will display a dump 
file choice menu. 


ON <diskname> 


This option informs PMB90 on which disk it has to search for a memory dump file. 


NOTE 
If GET and ON option are both specified, then the GET option should pre- 
cede the ON option. 


ON TAPE 


This option informs PMB90 that the memory dump file has to be found on a magnetic tape labelled 
““MEMDUMP/MEMORY’”’. 


MERGE 


This option informs PMB90 that its memory dump file is to be assembled from two or more files held 
on different disks. This facility is required for situations in which the memory dump file of the machine 
being dumped is too large to fit onto one removable disk. 


NOTE 
The specification of MERGE in the initiating message excludes specification 
of any other option. 


PMB90 can also be started from a TD 830 capable datacomm terminal. Once started, the utility dis- 
plays a screen on which the user may select the filename to be analysed, and the device on which has 
to search for this file. If the file is found and successfully opened, the utility displays the base menu 
screen. From this screen, the user may choose one of the options described in the following paragraphs 
with the exception of the HELP option. When choosing one of these options the utility displays an- 
other screen where the user may choose one of the specific parts from the memory dump file to be 
analysed. 


Using The Utility 


Where the console is to be used for communication, the user is informed if no console is available, 
and is given the opportunity to make a console file available. Non-printer console files allow up to 
224 characters input. 


The analysis takes place in an interactive manner. All available options and instructions on how to 
use them are provided in response to the input ‘“HELP”’’. Further details on a particular option are 
provided in response to the input ‘‘HELP option’. A knowledge of the MCP is required in order to 
diagnose the reason for any particular memory dump. 


The complete dump options are given here in railroad diagram format, with further details in the fol- 
lowing paragraphs. 


Syntax Of Input Specifications 


< print option > 
i < display option > 
| < check option > | rp— BYE—+ 
< patch option > - panes 
< save option > END 


< help option > =| 


Print 

This option specifies that output from the following list of <print-option>s is to be printed on the 
console. 

Display 


This option specifies that output from the following list of <print-option>s is to be displayed on the 
SELF-SCAN screen. In this case the SET.SCREEN parameter should have been used in the initial mes- 


sage. 
Check 
The two <check-option>s are MEMORY.LINKS and ALL.MEMORY. The MEMORY. LINKS op- 


tion gives a print of all memory links from the initial pointer (PTRX) until the end of the chain or 
an inconsistency is reached. 


Save 

This option enables a copy of the dump (patched if required) to be made on the specified disk with 
the specified file-name. 

Patch 

This option enables an invalid area of memory to be patched in the dump, to enable PMB90 to contin- 
ue its analysis. : 

Help (Non-Interactive PMB90 Only) 

If no <help token> is specified, the list of available <options> is displayed. Otherwise, for each 
specified <help token>, the available sub-options are listed (if any) with a short semantic description. 


NOTE 
All <identifiers> input in the same line as ““HELP”’ will be taken as <help 
tokens >. 


Also “HELP” is not valid input when PMB90 is being run as a datacomm applications program. The 
user is guided by the menu displays. 


End, Bye 
These alternative options cause PMB90 to go to normal EOJ. 
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<print option> 


ALL.MEMORY 
GLOBAL 
ESCT 


DIAGNOSTICS 
>—— PRINT SAT 


PHDUMP 
C.TABLE 
SCL 
DUMP.CODE 
TASK.TABLE 


VMWA < page option > 


GWA 

SLICE <slice option > 

TASK < task option > 

PHT < device option > 
MEMORY.MAP < page option > 
MEMORY.LINKS < page option > 
MEMORY.FAULTS 

MIX 


OL 
DATA.COMM.AREA 
HEX <hex option > 


SHARED.CHAINS < page option > 
<display option> 


OL 
>— DISPLAY HEX <hex option > 
< check option > 


< datacomm display option > 
<check option> 


ALL.MEMORY 
>— CHECK 22, 


eee MEMORY.LINKS 
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<patch option> 


NEXT 
< hex digit list > 


>—_ PATCH | 
2 eee a ie < address > < hex digit list > = 
< address > = jis a hexadecimal number of one to four digits. 


i 


<hex digit list > is n hexadecimal digits, where n = 2. 


<datacomm display option> 


DIAGCBUF WAITSPIM VMG VERSIONINFO 
SPO.DATA SCL PSEUDO.REG.DUMP SAT 

PHDUMP OPTIONS INTERGLBL GLBLM 
DEBUG.GLOBAL DEBUG.EXTRA CURRENT.DICTIONARY MIX 

CT.INFO REMOTE.SPO.GLOBAL ROMDUMP OL 

LOGGING NUMERICLIMITS APPEND.STORE — 


VMWA <page option> 
PHT <device option> 
HEX <hex option> 


<save option> 


>—— SAVE 
< file-id > 
ON —— < pack-id > 


< file-id > 
< pack-id > 


valid CMS file identifier 
a valid CMS pack identifier 


<help option> 


>—— HELP 
< help token > 


where <help token> = 


ALL.MEMORY GLOBAL ESCT 
DIAGNOSTICS SAT PHDUMP 
C.TABLE SCL DUMP.CODE 
TASK.TABLE VMWA GWA 

SLICE TASK PHT 
MEMORY.MAP MEMORY.LINKS MEMORY.FAULTS 
MIX OL HEX 
DATA.COMM.AREA HELP PRINT 
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DISPLAY CHECK SAVE 

PATCH END BYE 
PRINT.OPTION DEVICE.OPTION SLICE.OPTION 
TASK.OPTION WA.OPTION DATA.SEGS.OPT 
PAGE.OPTION DISPLAY.OPTION SHARED.CHAINS 


<slice option> 


< data segments option > 


< page option > 
< named slice > 


< numbered slice > 


Where <named slice> = 


DISKDDR LPDDR PANDDR DSKSDI MCHSN 
SYSDISPSN CASSDDR SENDDR ENDCRSN MTPRSN 
TICKRSN KBDDR DCCH ADCDDR SDCDDR 
INITIALISE TCDDR DCMESS ICMDDDR OPENCLOSE 
CONBUFSN SUSN SPO REMSPOSN SCREENSN 
SCLBUFSN 

<numbered slice> = an integer in the range 0 — 123 inclusive. 


<page option> 


< page name > 


< page number > ee 


<page name> ZERO/ONE/TWO/THREE/FOUR/FIVE/SIX/SEVEN 


i ot 


<page a non-negative integer 

number > 

<data segments = DATA.SEGMENTS/NO.SEGMENTS 
option > 


<device option> 


< device name > 


Where: 
<device name> = SP LP CT DK DF MT RT SC DCP KB SDC ADC DM CX DI 
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<task option > 


< numbered task > 


< named task > < work area option > 


CURRENT 


an < data segments option > 
Where: 

<numbered = an integer in the range 0-31 inclusive 

task > 

<named takk> | NDL MCS RSF BAILIFF SCL LOADER 
<work area = COBOL MPLII SORT BIL NDL RPG MCS 
option > 


<hex option> 


cas an a a < address > 
< page option > 


Where 
<length> = a hexadecimal number of 1 to 4 digits. 


<iendih > -—— > —— > 


ALL.MEMORY 


This option creates analysis of fixed MCP data areas, configuration table and task table if present, 
all peripheral handler tables, memory links and analysis of all locked slices in memory plus all overlay- 
able code and data segments present in memory at the time of the dump. 


GLOBAL 
This option creates an analysis of the fixed MCP data area. It includes the last code executed. 
C.TABLE 


This option gives a print of the configuration table, if it was in memory at the time when the dump 
was taken. 


ESCT 

This option gives a print of the mix table (execution scan priority table). 
DIAGNOSTICS 

This option gives a print of the MCP’s diagnostic buffer area. 

TASK. TABLE 


This option gives further analysis of the mix, if the overlayable task table was present in memory at 
the time when the dump was taken. 
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MEMORY.MAP 


This option provides an analysis of the layout of memory and may be output for any specified page. 
MEMORY.LINKS 

This option analyzes the layout of the overlayable area of memory and may be output for any specified 
page. 

VMWA 


This option gives a print of the virtual memory work area only. 
GWA 


This option gives a print of the global work area only. 
SCL 


This option prints the keyboard buffer only. 
SAT 


This option gives a print of the slice address table only. 

MIX 

This option gives a selective analysis of parts of the dump relating to the tasks running at the time 
of the dump. 

OL 


This option gives a selective analysis of peripheral configuration information. 
DATA.COMM.AREA 


This option prints the areas of memory relating to data communications. 
PHT 
This option gives a print of selected peripheral handler tables. If the <device-option>s are absent, 


then all peripherals attached to the system at the time of the memory dump are analyzed. Allowable 
values for <device-option> are: 


CX Channel expander 

LP Line printers 

SP Serial (console) printer 

CT Cassettes 

DK Cartridge disks 

DF Fixed disks 

DM BSM, BSMII disks 

KB Keyboard 

SC Screen 

ADC Asynchronous data comm controllers 
SDC Synchronous data comm controllers 
DI ICMDs 

RT Time-of-day clock 


tty eee ee ee ee SSS See 


DCPP Data communication power pak 
MT Magnetic tape 
SLICE 


This option provides s 
allow for associated se 


MMS a Sai pre Ue 
the range 123, 


DISKDDR 
LPDDR 
PANDDR 
KBDDR 
CASSDDR 
SENDDR 
SCREENSN 
SUSN 
INITIALIZE 
SDCDDR 
DCCH 
CONBUFSN 
ICMDDDR 


TASK 


RTCDDR 
DCMESS 
TICKRSN 
SYSDISPSN 
DSKSDI 
ENDCRSN 
MCHSN 
MTPRSN 
ADSDDR 
OPENCLOSE 
SPO 
SCLBUFSN 
REMSPOSN 


This option prints the contents of a task control block (TCB). 


The <task-name> may be one of: 


NDL 
RSF 


BAILIFF 


SCL 


LOADER 


The <wa-option> may be one of: 


HEX 


This option provides a print (or display) in hexadecimal and 
The <start address> is a four-hex-digit number and the < 
digit number. 


PHDUMP 


This option causes the peripheral handling dump area to be output.. 
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elective printing of locked slices of memory or of data segments. It does not 
ements to be output. The <slice-option> may be either a ‘‘slice-number”’ in 
one of the following names: 


byte format of selected pairs of memory. 
length> is also specified as a four-hex- 
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DUMP.CODE 


This option will cause 1024 bytes of the code that was being executed at the time the machine was 
halted to be dumped to the printer (in hex format). This enables the user to check for code corruption. 


MEMORY.FAULTS 


This option will analyse memory links, all peripheral handler tables and all slices in memory, but will 
only output error messages for any inconsistencies encountered. 


SHARED.CHAINS <page option> 


This option will cause an analysis of any shared slices found on the page specified to be sent to the 
printer. If <page option> is omitted, all pages in the memory dump will be analysed. 


<datacomm display option> 


The following names of absolute maps can be displayed on the user’s datacomm terminal: 


DIAGCBUF APPEND.SORE 
WAITSPIM VMG 

VERSIONINFO SPO.DATA 
SCL(BUFFER) SAT(M) 
PSEUDO.REG.DUMP PHDUMP 

OPTIONS INTERGLBL 

GLBLM DEBUG.GLOBAL 
DEBUG.EXTRA CURRENT.DICTIONARY 
CT.INFO REMOTE.SPO.GLOBAL 
ROMDUMP LOGGING 
NUMERICLIMITS 


These maps cannot be displayed when PMB90 is running via console I/O or ACCEPT/DISPLAY. Also 
valid for display on the datacomm terminal are: 


PHT <device option> 
VMWA <page option> 
MIX 

HEX 

OL 


HEX, MIX and OL are the only options that are also valid for display via console I/O and ACCEPT/ 
DISPLAY. 


NOTE 
When submitting memory dumps for analysis, it is helpful if some 
preliminary analysis has already been performed. The following option is rec- 
ommended: 


PMB90 
PRINT MIX OL MEMORY.MAP MEMORY.LINKS GLOBAL PHT TASK CURRENT 


Always provide the MEMDUMP file on magnetic media even if this preliminary analysis has been per- 
formed. 
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initiating PMB9O 


In a non-datacomm environment the initiating message is as defined previously in ‘‘Starting The Util- 
ity”? (see railroad diagram). 


Example: 


PMB90 or 
PMB90 AX 


For interactive mode, the initiating message entered from the application page is: 
<cc>RN PMB90 


where <cc> is the control character used on the system. A GEMCOS/TMCS interface and a TD 830 
like terminal is assumed. 


If an attempted execution in non-RN mode takes place, that is, the user is attempting to attach to 
an already running PMB90, the user will be warned by PMB90 to use RN and he will be detached. 
Similarly, if the GEMCOS/TMCS interface is not set, then a warning will be displayed at the user’s 
terminal by PMB90 and he will be detached. 


A new command ‘““MERGE”’ is used in the initiating message. 
Example: 


PMB90 MERGE or 
PMB90 MERGE AX or 
RN PMB90 MERGE 


NOTE: Specification of any one of the commands: 

GET <file-id> 

ON <pack-id> 

ON TAPE 
in the initiating message along with MERGE, will be detected as an error by PMB90 and cause termina- 
tion of the run. 


Following a valid initiating message, PMB90 will prompt: 


ENTER PACK ID AND FILE ID FOR MERGED FILE IN FORM 
<pack-id > / < file-id > 
A NULL REPLY WILL RESULT IN MERGED FILE CALLED 0000000/MERGEDUMP 


NOTE: Null reply is one of the following: 
1. A null accept if ‘“‘AX’’ was specified in the initiating message or 
2. <RETURN> if console input is being used (“‘AX”’ not specified in the initiating message, OF 
3. <RETURN> if PMB90 is running as a datacomm applications program. 


PMB90 will attempt to create a merged dump file with the specified name but will not succeed if: 
1. The file already exists (remove it, change its name or specify different name for merge). 
2. The disk is not on line. 
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If the disk cannot be opened, PMB90 will again prompt for a merge file name with final ultimatum. 
If the disk cannot be opened, PMB90 will again prompt for a merge file name with an ultimatum. 


If the disk is opened successfully, PMB90 will prompt the user with: 


LOAD AND READY DISK WITH MEMDUMP PART 1 
ENTER PACK ID OF DISK 


PMB90 will look for the specified disk and attempt to open a file MEMDUMP on it as part 1 of 
the split dump file. This will be copied over to the file specified earlier and PMB90 will then prompt: 


LOAD AND READY DISK WITH MEMDUMP PART ?) 
ENTER PACK ID OF DISK 


PMB90 again searches for a file MEMDUMP on the specified disk and this operation is repeated until 
all the split files of the dump have been processed. 


PMB90 will then prompt: 
MERGED DUMP FILE CREATED 
INPUT DUMP OPTIONS REQUIRED 
The user can now continue with the dump analysis in the usual way. 


On completion of the PMB90 run, the merged file will be left on the disk and any subsequent analyses 
may be done using an initiating message of the form: 


PMB90 AX GET MERGEDUMP 
Early Merge Termination 


The facility exists to stop the merge process and instruct PMB90 to commence analysis of the memory 
dump file assembled so far, once the first split file has been processed. After PMB90 has prompted: 


LOAD AND READY DISK WITH MEMDUMP PART n [n = 2] 
ENTER MFID OF DISK 


The user may enter MERGE.OVER to terminate the MERGE process. 
Once MERGE is terminated, the PMB90 will then prompt: 


MERGED DUMP FILE CREATED 
INPUT DUMP OPTIONS REQUIRED 


The user can now commence normal dump analysis. 

NOTE: 

If the user enters MERGE.OVER when PMB90 expects PART | of the dump file, this causes the fol- 
lowing message to be displayed: 


NO MEMDUMP FILE YET READ IN SO PMB90 CANNOT ANALYSE 


Further prompts will request the user to: 
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LOAD AND READY DISK WITH MEMDUMP PART 1 
as previously described. 
NOTE 
The user is advised that this facility should be regarded as for emergency use 
only, as the behaviour of PMB90 when analysing a truncated dump file is 
unpredictable. The only circumstances in which it might be reasonable to use 
this facility are if part of a dump was lost or unreadable due to corruption. 


Alternatively a user may wish to be able to assemble part of a dump, for 
example, where he intends to analyse something known to reside in page 0 
of memory and which is therefore near to the beginning of the dump. 


NOTE 
Under no circumstances will PMB90 allow a user to skip a split file, that is, 
follow a PARTn with PART n + 2. 


203280! a4 


hs 
B90 DEPENDENT INTRINSICS 


The following pages describe intrinsics which are included in the B 90 MCP only. 
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GT (Generai Trace) 


The general trace command is an MCP intrinsic which displays various diagnostic information either 
on the system console or on the line printer. The general format is: 


Format: 


< printer peripheral > 


aes < diagnostic class > — 


< disk-peripheral > 


To turn the trace printing on, with printing on the console (SPA) enter: 


GT ON 


To direct the diagnostic printing to a line printer, specify the printer peripheral. For example: 


GT LPA 
Note that the trace must also be turned ON in this case. The trace will be interleaved with any program 
printout. 


To turn the trace off, enter: 
GT OFF 


To display the cumulative number of retries performed on a disk unit since the last warmstart, specify 
the desired peripheral. For example: 


GT DMA 
The general B 90 machine code trace is implemented as follows: 


Each trace point is identified by a diagnostic class and a diagnostic value. The class is one of 16, identi- 
fied by a hex digit (0-F). This identifies the system function being performed, as follows: 


0 Open/close file handling routines 

1 Indexed file handling 

2 Accept/display routines 

Intrinsic functions (for example, SORT INTRINS) 
Automatic volume recognition (AVR) routines 
BAILIFF (task handling MCP routine) 

Disk space allocate/deallocate routines 
Interpreters (BILINTERPX, COBOLINTX, NDL.INTERPX) 
MCP communicate handler (MCH) 

Virtual memory (VM) routines 

Task control routines (for example, BAILIFF) 
I/O master interrupt handler (MIP) 


bad 
~ 


~TMINDAWPwonH 
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The diagnostic value is a hex number (0-F) giving a measure of depth of trace required (0 is least signif- 
icant, F is critical). 


The GT command allows the storage of a switch-value for each diagnostic class. If the trace has been 
initiated via the GT ON command, then each time a trace point is encountered in the machine code, 
a diagnostic printout will occur if the switch-value for that class of trace is lower than or equal to 
the diagnostic value of that trace point. For example, if a particular trace point had a diagnostic value 
of C, then a trace point would occur if the switch-value for the appropriate class was in the range 
0-C inclusive. If the switch-value set by the GT command was D, E or F, no trace print would occur. 


The default values set at warmstart are: 
trace option OFF 
diagnostic print directed to SPA 
all switch-values set to F. 
Therefore the only trace prints that will normally occur are the critical ones (diagnostic value F). 


Note that if the trace option is ON, the PK lights display the current trace point, whether or not the 
printing takes place, as follows: 


diagnostic-class diagnostic value 
in binary in binary 
(0000 — 1111) (0000 — 1111) 


For example, a trace point with class D (binary 1101) and severity 7 (binary 0111) will cause PK lights 
17, 18, 20, 22, 23 and 24 to be lit. 


The switch-value entered in the GT command must contain two hex digits: 


first digit — switch-value for register diagnostics 
second digit — switch-value for memory diagnostics 


If no options are specified for the GT command, then the current switch-values for each of the 16 
diagnostic classes are displayed. 


Examples: 


To find the retry count for DMA and DKA: 
GT DMA 
DMA 0 RETRIES 


GT DKA 
GT DKA INVALID — DEVICE NOT ON SYSTEM 
ENTER OL FOR MORE DETAILS 


To set the switch-values to CC for interpreters, then interrogate all switch-values, then turn on printing 
to LPA: 
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GT B CC 


GT 

DIAGNOSTIC LEVELS SET ARE FFFFFFFF FFFFFFFF 
FFFFFFCC FFFFFFFF 

GT LP 

GT ON 


Note that only the disk peripheral option and the GT command with no further options result in an 
immediate response to the operator. 
Format of Diagnostic Printout 


The format of a register diagnostic message is given here, where each X represents 4 single hexadecimal 
digit. The hex string is printed on one line. 


register: AD BO BIFL J K L 
XX XX XXXX XXXX XXXX XXXX 
register M1 M2 WR x Y ? MXA MXB UMRX AD,ESCT 
XXX XXXX XXX XXXKXXXK XXMKXXKK XXXX KRXX XXXX XXXX 


The diagnostic class and vaiue are given by the AD register (first 2 digits, repeated in first pair of 
1 


last four digits). For example, a DF diagnostic with M1 = 1111 would look like: 


DF xx XXXX = XXXKX —-XXXKX_— XXXK —_ XXXX 
1111 XXXX XXXX XXXXX XXX XXXXXXXX XXXX  XXXX XXXX DF xx 


where x indicates any hexadecimal digit. 


When GT is switched on, system fatal errors (which would normally result in a set of PK lights 17 
to 24 flashing) are reported as a diagnostic printed message followed by initialization to the Initial 
state. A memory dump should normally by taken to find more information. When GT is switched off, 
the pattern of PK lights 17 to 24 that are set flashing on a system fatal error correspond to the value 
of the AD register. 
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ENHANCEMENTS TO LOGGING 


The SPO feature on B 90 systems allows more than one SPO device to be used on the system. This 
creates a problem in the routing of SCL responses. To ensure that SCL responses go to the device 
which solicited the output, the system uses the fields ODT ID and ODT TAG. These entries are now 
included with any system message log entry recorded within the log files. They are used to identify 
which type of device and, in the case of multiple terminal SPOs (MTS), which station issued or received 
the logged SCL message. 


The ODT ID field is the field which identifies the SPO device type. The user may now determine 
whether the SCL was to or from a console type SPO, a program SPO (SPIM) or an MTS terminal 
SPO. 


ODT Issuing or Receiving Device Type ODT TAG 
ID 
@FF@ Initial (zipped from SYSCONFIG) @FFFF@ 
@0@ Local (Console or Self Scan) @0000@ 
@01@ MTS Terminal Logical Station Number 
@70@ SPIM Terminal @0000@ 


The ODT TAG field provides the user with information to allow the identification of which MTS ter- 
minal issued or received the SCL. The ODT TAG should be regarded as a 16 bit value and is split 
into two separate sections. The first section, bits 0 to 4, has been reserved for future expansion. Bits 
4 to 15, the second section, provide the Logical Station Number (LSN) of the SCL device which issued 
or received the message. The value of the LSN is in hexadecimal notation, thus an ODT TAG value 
of hex 0028 would refer to station 40 within the network. 


Variations To PL And IR Caused By MTS 


When SCL is input, or if a data comm task is executed from a terminal which is the controlling SPO, 
any SCL output produced will be directed only to that SPO. This is altered if the terminal is not the 
controlling SPO. In the case of a terminal which is not a controlling SPO, the SCL is routed both 
to the SPO page of the terminal and to the controlling SPO, if present. A similar type of system is 
used when any attempt is made to view the contents of the message log files. 


When the PL utility is used to print out the message log files, the resulting output depends on which 
SPO initiated the utility. If the utility was started from the controlling SPO, the entire content of the 
message log within the given parameters is printed. If the utility was initiated from a non controlling 
SPO device, a selective printout is output giving only the SCL related to that particular SPO. 


The use of the IR, LB and LF functions of SYS-SUPERUTL has been changed to work in a manner 
similar to PL. The messages displayed on a non-controlling SPO are only those associated with that 
particular terminal. A terminal which is the controlling SPO would have all required SCL messages 
recalled and displayed. 
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SECTION 9 
B 900/CP 9500 DEPENDENT SYSTEM SOFTWARE 


INTRODUCTION 
This section discusses those functions of CMS that are unique to the B 900/CP 9500 systems. 


The discussion is intended for two types of user. 


1. Systems operators who wish to know how things work. 
2. Software support personnel who need more technical information. 


To accommodate these two audiences, this section is divided into subsections. Operational descriptions 
of procedures are given first. Functional descriptions follow. 


In addition, at the end of this section there is a subsection titled Utilities and Intrinsics. These utilities 
and intrinsics are either unique to this system or have some feature that is unique to these systems. 
For a discussion of other utilities and intrinsics, refer to the earlier sections of this manual. 


The descriptions of these features are written in such a way that both system operators and support 
personnel can find the information they need. 


CONTROL PANEL 


The first step in learning how to operate the computer system is to become familiar with the controis 
on the central processor. These are shown in figure 9-1. 


The hexadecimal keypad at the left is usually covered. It is used to run maintenance test routines 
(MTRs), to take ROM-generated dumps (explained later in this section) and to run COLDSTART func- 
tions when no local SPO exists. 


At the upper right of the control panel is a series of switches. Some design levels have more switches 
than others. These switches are used to perform coldstart functions, take a memory dump and pass 
control to backup processors. 


At the left is a set of lighted displays that flashes on and off when the system is operating. The num- 
bers shown are significant. Most indicate normal operation or are for maintenance purposes. The Func- 
tional Description subsection discusses these numbers in detail. The time is displayed in the bottom 
set of lights. 


Data Communications Transmit and Receive Indicators 


These four pairs of lights are used by the B 900/CP 9500 to indicate when it is transmitting to, or 
receiving from, a terminal on a particular data communications line. 


Data Communications Group Select Switch 


This seven-position thumbwheel switch is used to select a four-line group of data communications lines 
for monitoring on the four pairs of transmit and receive indicators. 


OPERATOR ATTENDED/UNATTENDED 


Systems are described as either: 
Operator attended, or 
Operator unattended. 
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B 920/CP 9570 


OPERATE 


MEM OUMP 


HEXADECIMAL DISPLAY 
SPARE KEY 2 ROWS OF 8 DIGITS 


TRANSMIT 


O000 


RECEIVE 


HEXADECIMAL KEYPAD DATA COMM INDICATORS THUMBWELL SWITCH 
(COVER REMOVED) 


Figure 9-1. Control Panel 


In operator attended mode, a Supervisory Printer Output (SPO) is part of the system. This SPO looks 
very much like a typewriter attached to a television screen. An operator types information on the key- 
board to communicate with the processor. The numbers and words typed on the keyboard appear on 
the screen. The operator pushes a button on the keyboard to transmit the information on the screen 
to the system, and responses from the computer appear on the screen. 


A SPO is shown in figure 9-2. 
In operator unattended mode, there is no SPO. The operator starts the system by pushing the appropri- 
ate buttons on the control panel. The entering of commands in this mode is handled by a terminal 


on the data communications system which has been especially designated for this work. This terminal 
is called a Remote SPO. 
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Figure 9-2. SPO 


For the Remote SPO to function, a program called SPO Interface Module (SPIM) must be present 
on the system. The operations of the SPIM program are beyond the scope of this manual. However, 
this manuai does explain WARMSTART/COLDSTART in unattended mode. 


With the 3.05 release, the functions of SPIM can be handled by the Enhanced Terminal SPO (ETS) 
feature (explained later in this section). 


The rest of this section focuses on the operation of systems where a SPO is present. 
SYSTEM START-UP 


In starting the system, the operator should understand that there are two different kinds of on and 
off. There is a physical on and off where the actual equipment is involved and there is logical on and 
off where the internal processing system is made ready to begin work or to shut down. 


In a typical day, a system operator turns the physical system on (power-on); brings up the software; 
does whatever work is scheduled; logically powers-down and then physically shuts off the equipment 
(figure 9-3). 


For more specific information on the powering on and off procedure, refer to the B 900/CP 9500 Op- 
erators Manual, form 1166360. 


Physical Power-On 
Each piece of equipment has an ON and OFF switch. 


The most important thing to remember when turning on equipment, is to do so in the appropriate 
order: 


1. Turn on the processor 
2. Turn on the SPO (if the system has one) 
3. Turn on the fixed disk unit (if present) 
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POWER-ON EQUIPMENT IN 
CORRECT ORDER 


1. PROCESSOR 
2. SPO 


3. FIXED DISK (IF PRESENT) 
4. OTHER PERIPHERALS 


SET 
SYSTEM/REMOVABLE 
SWITCH ON CONSOLE 


PRESS ON/CLEAR BUTTON 
DO COLDSTART PROCEDURE TO: 


1. INITIALIZE DISKS 

2. LOAD NEW SOFTWARE 

|3. RELABEL OR REFORMAT DISKS 
4. BINARY COPY DISKS 


PRESS ON/CLEAR BUTTON 
DO WARMSTART 


PROCEDURE FOR 
REGULAR DAILY 


ACTIVITY 


SHUTDOWN 
PROCEDURE 


Figure 9-3. Block Diagram of Operating Steps in Daily Running of B 900/CP 9500 


4. Turn on the other peripherals, for example, removable disk units (including PACK and the 
PACK controller) and printers. 


Equipment is turned off in the reverse order after the logical power off. 


WARMSTART 


In normal day-to-day system operation, warmstart is the way the system is made ready to do work 
(logically ready). The warmstart instructions assume the hardware has already been turned on in the 
correct order. 


System With SPO 


In a system that has a SPO, the warmstart procedure is as follows: 
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1. Set the SYSTEM/REMOVABLE switch on the processor to SYSTEM. 
2. Press the ON/CLEAR button. 
Some time passes. 


Pressing ON/CLEAR causes the system to display a message on the SPO which gives the version of 
the Burroughs Master Control Program, lists the equipment that is on-line and requests the correct 
date and time. 


A sample message is: 


BURROUGHS CMS MCP 3.05.00 

DFC SYS1/0 FILES OPEN 

DF =SYS DISK 

DFD SYS2/0 FILES OPEN 

ENTER DATE AND TIME USING DT COMMAND 
COMMENCING LOG FILE CONSOLIDATION 


3. The operator should type in the command DT, the correct date using numbers separated by 
slashes and the time with no punctuation. 


Example 
DT 11/14/84 0920 


Leading zeros are needed. For example, February must be entered as 02; 9 a.m. as 0900. 


The system does not accept any other format for entering the date and time. After this information 
has been typed in correctly, press the XMT button to transmit. 


At this point the computer does internal work. A short period of time passes and a series of numbers 
flashes on and off on the display panel. When the internal processing is complete, a message appears 
on the display screen similar to this: 


14 Nov 84 84315* 1020 

TRANSFER COMPLETED 

COMMENCING LOG FILE REALLOCATION 

LOGGING IS INITIATED ON 11/14/84 at 10:22:32 (MCP VERSION 03.05.00) 


* Julian date 
When the MCP version message appears, the system is warmstarted. 


Warmstart Variations 


1. If the system has no SPO, or if the NORMAL/EXTENDED switch is set to EXTENDED, the 
system uses the default values of 11/11/11 for the date and 24:00:00 for the time. The warm- 
start procedure is entered automatically if the SYSTEM/CONFIGURATION switch is set to 
SYSTEM and the ON/CLEAR button is pressed. 


2. If there is no fixed disk unit or if the fixed disk unit is not to be powered on, a disk with 
the required system files (the system disk) must be inserted in the removable disk drive desig- 
nated as the loader channel. The rest of the procedure remains the same. 
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Coping With Problems 


If something has gone wrong with the warmstart procedure, the simplest method of correction is to 
turn off the equipment and start again. 


Some common things that may cause the warmstart to fail are: 
Disk unit not turned on 
Removable disk is disabled 
Something was typed incorrectly 
You forgot to transmit, or you hit the wrong button when attempting to transmit. 
Required system files are missing or corrupt. 


If restarting does not correct the problem, consult the lighted numbers on the display panel. The num- 
bers constitute an error message. The meanings of these messages and suggested ways of correcting 
problems are given under Functional Description later in this section. 


COLDSTART 


The COLDSTART procedure is used by both system operators and field engineers. 
There are several reasons for an operator to do a COLDSTART. For example: 
1. New disks need to be initialized (made ready for use). 
2. The computer is new and the system files must be loaded for the first time. 
3. Burroughs has made improvements to the software and a new level of system software must 


be entered. 
4. The operator wishes to relabel, reformat a disk or do a binary copy. 


There are other uses for COLDSTART, including: 


1. Initializing maintenance test routine (MTR) disks (the FE command). 
2. Installing additional fixed disk units to the system. 


The last two uses are explained in the COLDSTART Functional Description subsection as they are 
more likely to be used by field engineers than by the system operator. 


There are three types of COLDSTART operation: 

1. Operator attended (SPO is present). 

2. Operator attended (no SPO is present, system options are entered through keypad). 

3. Operator unattended (there is no SPO and system options are selected by switches). 
Operator attended mode is explained first, followed by a brief explanation of unattended operation. 
COLDSTART Initiation 
Procedure 


The first steps of the COLDSTART procedure are much the same for any COLDSTART activity. The 
hardware should be turned on. 


1. Insert the B9OORLI disk in the loader device (write disabled). 
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2. Set the SYSTEM/REMOVABLE switch to REMOVABLE and put the other switches in their 
primary positions (STANDARD, NORMAL, OPERATE, DISK PROCRI1 and OSPROC]!). 


3. Press ON/CLEAR button on processor. Wait a few minutes. 
COLDSTART Attended Mode — SPO Present 
Carry out steps 1 to 3 of the initiation procedure then continue as foliows. 


The system displays a message on the SPO screen giving the version number of the MCP operating 
the system and requesting the date. 


Exampie: 
BOJ COLDSTART 03.05.00 
ENTER DATA <MM/DD/YY> 
(BOJ stands for Beginning-Of-Job) 


4, Enter the date in the style requested. Leading zeros must be included. 


Example: 
01/04/84 

The system responds by telling the operator what disk drives are on-line. Example: 
DMA: B900RL1 
DFD: 0000000 


BNW A 


bitsy was 


5. After the system responds with the following message, the operator can enter one of the func- 
tions from table 9-1. 


ENTER FUNCTION <BC, FE, IN, LD, OL, RF, RL, RP, WS> 
NOTE: TO PRINT A BRIEF EXPLANATION IN RESPONSE TO ANY PROMPT, ENTER 
*sOBEX’? 


Table 9-1. COLDSTART Functions 


Binary Copy: duplication of removable disks. 
Discontinue: terminates the following functions: BC, FE, IN, LD, RL, RF, RP. 
Explain: provides an explanation when COLDSTART expects a response. 

Field Engineering: test function used by Burroughs engineers. 

Initialize: initializes a disk. 

LD Load: loads files from release disk to system disk. 

On-Line: lists status of drives on system. 

Reformat: clears information from disk but does not check for bad sectors. 
Relabel: relabels a disk. 

Replace: replaces system files on the system disk with the files from B900RL1. No 
checks are performed. 

Warmstart: warmstarts the system. 
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BC (Binary Copy) — 


BC allows rapid duplication of removable disk media that are the same type and size. The function 
copies all sectors from one CMS removable disk, called the source disk, to a second CMS removable 
disk, called the target disk. The function preserves the BOOTSTRAP portion of track zero on the tar- 
get disk, as well as some labelling information. The three phases of the binary copy function are disk 
selection, copy and verification. 
NOTE 

The function does not update the pack-id of the data file part of indexed 

pairs. Therefore, if an indexed pair is copied from disk A to disk B, the key- 

file still contains the data file pack-id as ‘“‘A’’. To avoid this situation, the 

target should be given the same pack-id as the source disk. 


Procedure 


The NORMAL/EXTENDED switch should be set to NORMAL. If a local SPO is connected to the 
system, binary copy will be prompted from the SPO keyboard, and its messages will be displayed on 
the SPO screen. If no local SPO exists, the function will be prompted from the keypad and will display 
its status in the indicator display blanks next to the keypad. 


1. Enter BC when the message ENTER FUNCTION appears. 

2. Enter the drive-id of the target disk. 
Display — ENTER DRIVE-ID OF TARGET DISK <3 characters such as ‘‘DKA’’> 
ENTER — <drive-id> or ?EX for explanation 


3. Enter pack-id to be inserted into the label of the target disk. The disk-name consists of from 


one to seven characters (A-Z, 0-9, . —) 
Display — ENTER DISK-NAME TO BE ASSIGNED TO THE TARGET DISK 
Enter ~ <disk-name> or ?EX for explanation 


4. Enter drive-id of the source disk. 
Display — ENTER DRIVE-ID OF SOURCE DISK <3 CHARACTERS SUCH AS “DKA’’> 
Enter — <drive-id> 


For an explanation of the error messages which may occur during the disk selection phase, refer to 
table 9-2. 


COLDSTART determines that the source and the target disks are the same type and the copy begins. 
If any block of 32 sectors on the source disk cannot be read, the block will be replaced with binary 
zeros on the target disk. If the function is unable to write to the target disk, the function will abort. 
Refer to table 9-3 for messages displayed during the copy phase. 


After the copy is completed, all sectors on the target disk are read to report all read parity errors en- 
countered. This phase guarantees the integrity of the copied data. Refer to table 9-4 for messages dis- 
played during the verification phase. 


NOTE 
The verification phase checks the target disk for parity errors only. No ‘‘com- 
pare’’ between the source disk data and the copied target disk data is per- 
formed. 
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Table 9-2. Error Messages of Disk Selection Phase of Binary Copy 


Invalid input — invalid disk type specifier 
detected 


A removable disk type cartridge (K), mini (M), or 
pack (P), was not specified for target or source 
| disk. 


Invalid input — invalid disk drive specifier Specified disk drive not in range from A to P. 
detected 


DXU: Not ready Specified target or source disk was not ready. 


Invalid input — one or more non-blank | The pack-id transmitted had a blank character 
characters are expected imbedded in the input. 


Invalid input — too many characters in Pack-id transmitted exceeded the maximum length 
disk name of seven characters. 


Invalid input — invalid character in disk- Pack-id transmitted contained character other than 
name (A-Z, 0-9, .—). 


Invalid input — source and target may not | Target and source disk provided referenced the 
be the same disk same disk. 


Warning — source and target disks have For information only — does not abort binary 
the same name copy. The disk name supplied for the target disk 


wom Bae. “ees +h an + 
Was: inesanie -asctne: Source disk name: 


ee EAS A SS A 


Error — source and target disks are not 
the same type 


End BC 


Target and source disks were not the same type 
and size. 


Function complete. 


Table 9-3. Error Messages Displayed During Copy Phase of Binary Copy 


Binary copy from <source mnemonic> to 
<target mnemonic> 


Information only — indicates the disk to disk copy 
has begun. 


Track zero on <disk mnemonic> has a 
bad sector. Binary Copy aborted 


One of the first 32 sectors on the target disk has a 
bad sector. The copy is aborted. 


The target disk could not be written because of a 
disk error. Another copy could be attempted with 
a different disk. 


When reading a block of 32 sectors, an error 
occurred that could not be isolated to the exact 
sector when reading each sector or source 
individually. 


Output error on target disk — try another 
disk. Binary Copy aborted. 


Transient input error in <start address> to 
<end address> 


This message heads a list of hexadecimal sector 
addresses which had errors and were copied as 
binary zeros. 


Input errors occurred on these sectors: 


This is the number of sector addresses listed, as in 
preceding message. 


<number> source disk input errors 
encountered 
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Table 9-4. Error Messages of Verification Phase of Binary Copy 


Checking target disk for input errors 


Information only — indicates the end of the copy 
phase and the beginning of the verification phase. 


Transient input error from <start address> 
to <end address> 


When reading a block of 32 sectors, an error 
occurred that could not be isolated to the exact 
sector when reading each sector of the target 
individually. 


This message heads a list of hexadecimal sector 
addresses on the target disk which contained errors. 


Input errors occurred in these sectors: 


The number of sector addresses listed, as in 
preceding message. 


<number> target disk input errors 
encountered 


Read check on target disk complete. Information only — indicates the verification phase 
is complete. 


oF 


| < source mnemon 


Ouran US 


mnemonic> as <target pack-id 


Information only — indicates the binary copy 
function is complete. 


Vv 
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?DS 


This command can be entered to ‘‘discontinue’’any of the COLDSTART operations. To use it, enter 
?DS in place of any response that is expected to contain three or more characters. 


FUNCTION DS-ED 
appears on the SPO. 
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FE 


This is a command generally used by field engineers (FE) to initialize disks which are used for mainte- 
nance test routines. (For an explanation of its use, refer to the COLDSTART Functional Description 
subsection.) 
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IN (Initializing Disks) 


When new disks are to be used for the first time, they must be initialized. Disks are also initialized 
when they have been used for a time and the information they contain is no longer needed. Essentially, 
this is re-initialization, but the procedure is still termed ‘‘initialize’’. 


Initialize does five main things. 
1. Makes the disk a B 900/CP 9500 disk. 


2. Sets up a disk directory. A directory is the first thing physically encountered on a disk and 
contains a record of every file on the disk, its name, size and location. When a disk is initial- 
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ized, the operator decides how many files the disk may have. 
3. Gives the disk a name, also frequently called a label. 


4. Checks the disk for bad sectors (sections). The number of bad sectors is reported to the 
operator. These portions of the disk are subsequently not used. Over long periods of time, sec- 
tors of a disk may become damaged. For example, if 50 or more sectors of a disk cartridge 
are no longer usable, it is wise to discard the disk. 


5. Erases all information previously on a disk. 
Procedure 
Follow steps 1 through 5 under COLDSTART Initiation, then proceed with step 6 as follows: 


6. When the message ENTER FUNCTION <BC, FE, IN, LD, OL, RF, RL, RP, WS> appears, 
put the disk to be initialized (often called a scratch disk) in an empty drive. Enter: 
IN 
at the SPO and transmit. 
The system responds with 
ENTER DRIVE-ID OF DISK <3 CHARACTERS, SUCH AS ‘‘DKA’’> 


7. Enter the three-character drive name of the drive where you placed the disk which is to be 

initialized. 

Example: 
DMA 

The system response is 
VALUES FOR DISK-NAME, OWNER’S ID, SERIAL NUMBER AND MAX-NUMBER- 
OF-FILES-ON-DISK MUST NOW BE ASSIGNED. DO YOU WISH TO ASSIGN THESE 
VALUES YOURSELF OR HAVE THE SYSTEM DO IT FOR YOU? 

ENTER ‘‘SELF’’ OR ‘‘SYSTEM”’ 


8. If you enter SYSTEM, all further information needed by initialize is derived from the default 
values. Refer to the Default COLDSTART Assignment subsection for a list of default options. 
The system automatically completes the initialization and displays the message: 

END IN 


9. If you enter SELF, the system responds with: 
ENTER DISK-NAME 
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10. Enter the name of the disk being initialized. The name is selected by the operator and may 
be up to seven alphanumeric characters long, beginning with a letter. 
The system responds with: 
ENTER SERIAL-NUMBER 


11. Enter a serial number up to six digits long. There must be some response to this request, so 
a six-digit number chosen at random may be entered if it is not necessary to keep records of 
disk serial numbers. 

The system responds with: 
ENTER OWNER’S-ID 


12. The owner’s-id may be 1 to 14 characters long. It is usual to enter either a company name, 
a department name, or the name of an individual. 
The system responds with: 
ENTER MAX-NUMBER-OF-FILES-ON-DISK 


13. Enter the number of files that is to be the maximum permitted on this disk. The possible range 
is from 1 to 2,804. For general use, a number between 250 and 300 inclusive is a good number 
to select for mini disks and cartridges. Between 1000 and 2804 is preferred for fixed disks and 
disk packs. The number you choose depends on how large you think your files will be. If 
you think you will be entering a large number of very short files, you may wish to make this 
number larger. 

When this information is received, the system proceeds to complete initialization. 
The message: 

END IN 

ENTER FUNCTION <BC, FE, IN, LD, OL, RF, RL, RP, WS> 
appears. 


To initialize another disk, repeat the IN procedure. 


Initializing Fixed Disks 


The 


fixed disk system is initialized if the system is new, a new level of software is to be loaded onto 


the system, or when additional fixed disk units are being added to the system. 


The 
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procedure is as already described, using DF= for the drive-id. 


LD (Load) 
New Software Received 


The procedure for installing new software is handled through COLDSTART. The tasks are done in 
the following order: 


1. Initialize or reformat the system disk(s). 
2. Load the new release using LD. 
3. Warmstart 


Procedure 


To initialize the disks on the system, follow the steps given for initialization (IN). Use the new 
B9OORL1 disk to do the COLDSTART. 


The initialization of the disks is finished when the message END IN or END RF appears, followed 
by ENTER FUNCTION <BC, FE, IN, LD, OL, RF, RL, RP, WS>. Proceed as follows: 


1. Enter 
LD : 
and transmit. The system responds to LD with the message: 
ENTER DISK-NAME OF DISK YOU WISH TO LOAD FILES TO 


2. The disk name may be one to seven alphanumeric characiers long, begin ing with 
PACK is the disk name for the fixed disk. 
The system then begins loading the system files. Each file is listed as it is loaded. It is possible 
that the information being loaded is on more than one disk. If so, they are labelled in sequence: 
B9OORL1, B900RL2, B900RL3. When all the information on one disk has been loaded, the sys- 
tem issues the following message: 


THERE IS NO DISK ON-LINE NAMED B900RL2 
AT THIS POINT, YOU MAY EITHER BRING THE MISSING RELEASE DISK ON- 
LINE AND CONTINUE PROCESSING, OR YOU MAY EXIT THE LOAD FUNCTION 
ENTER ‘““CONTINUE” OR “EXIT”’ 


3. If there is more than one release disk, remove the first one, place the next one in the drive, 
type CONTINUE and transmit. 
If there is only one disk or if you have entered the last disk in a series, type EXIT and transmit. 
If all of the system files have not been loaded, LD will issue a warning message. 
The remaining system files may have to be loaded individually. 
The successful completion of LD issues the message: 
END LD 


NOTE 
This function is intended to be used to transfer files from unmodified B 900 
release media onto a system disk. Any other use could give unpredictable re- 
sults. 
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OL (On Line) . 


This command lists the disks that are on-line. It functions in the same way as the OL command does 
during regular system operation. 


Example: 
OL 
is entered. The system responds with: 
DMB: ACCOUNT 
DFC: THISDSK 
DKG: PACK123 
END OL 
This means: 
A Burroughs super mini disk named ACCOUNT is ready on drive B. 
A fixed disk named THISDSK is ready on drive C. 
A cartridge disk named PACK123 is ready on cartridge drive G. 


The system requests the next function: 


ENTER FUNCTION <BC, FE, IN, LD, OL, RF, RL, RP, WS> 
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RF (Reformat) 
The Reformat (RF) COLDSTART command clears a disk (fixed or removable). 


RF is faster than IN. RF erases the disk directory, which is why it is so rapid. Old files are still present, 
but cannot be accessed and will be overwritten by new information.) This disk must have been initial- 
ized previously. 


However, the RF command does not check for bad sectors. If this command is used, the number of 
bad sectors reported will be the same as the number which was reported the last time the disk was 
initialized. Consequently, it is recommended that the CHECK.DISK command is run against any disks 
which are reformatted. 


CHECK.DISK will list all bad sectors. These bad sectors can then be removed using the XD (Delete 
Bad Disk Sectors) utility. 


If this is not done and any bad sectors are present, information may be written to these bad sectors 
and subsequently lost. 


Procedure 
Follow steps one to five under COLDSTART Initiation, then proceed with step 6 as follows: 


6. When the message ENTER FUNCTION <BC, FE, IN, LD, OL, RF, RL, RP, WS> appears, 
put the disk to be reformatted in an empty drive. Enter: 
RF 
at the SPO and transmit. 
The system responds with 


ENTER DRIVE-ID OF DISK <3 CHARACTERS, SUCH AS “‘DKA’’> 


7. Enter the three-character drive name of the drive where you placed the disk which is to be 

reformatted. 

Example: 
DMA 

The system response is: 
VALUES FOR DISK-NAME, OWNER’S-ID, SERIAL NUMBER AND MAX-NUMBER- 
OF-FILES-ON-DISK MUST NOW BE ASSIGNED. DO YOU WISH TO ASSIGN THESE 
VALUES YOURSELF OR HAVE THE SYSTEM DO IT FOR YOU? 

ENTER “SELF” OR “SYSTEM” 


8. If you enter SYSTEM, all further information needed by reformat is derived from the default 
values. Refer to the Default COLDSTART Assignment subsection for a list of default options. 
The system automatically completes the reformat, and displays the message: 

END RF 


9. If you enter SELF, the system responds with: 
ENTER DISK-NAME 


10. Enter the name of the disk being reformatted. The name is selected by the operator, and may 
be up to seven alphanumeric characters long, beginning with a letter. 
The system responds with: 
ENTER SERIAL-NUMBER 
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11. Enter a serial number up to six digits long. There must be some response to this request, so 
a six-digit number chosen at random may be entered if no records are kept of disk serial num- 
bers. 

The system responds with: 
ENTER OWNER’S-ID 


12. The owner’s-id may be 1 to 14 characters long. It is usual to enter either a company name, 
a department name, or the name of an individual. 
The system responds with: 
ENTER MAX-NUMBER-OF-FILES-ON-DISK 


13. Enter the number of files to be permitted on the disk, in the range 1 to 2804. Generally 250- 
300 is selected for mini disks, and 1000-2804 is chosen for fixed disks. 
When this information is received, the system proceeds to complete the reformat. 
The message: 
END RF ie 
ENTER FUNCTION <BC, FE, IN, LD, OL, RF, FL, RP, WS> 
appears. 


NOTE 


e system does not ask for serial number 


ill be requested for each fixed disk assem- 
sk is ‘‘DF=”’. 


When reformatting a fixed di 


sk 
and owner’s-id. Number of files 


< th 
Ww 
blage. The drive-id for a fixed di 
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RL {ReLabel) 


This function is used to relabel (retitle) removable disks, fixed disks and pseudo disks. 
Procedure 


Follow steps 1 to 5 under COLDSTART Initiation, then proceed with step 6 as follows: 


6. When the message ENTER FUNCTION <BC, FE, IN, LD, OL, RF, RL, RP, WS> appears, 


put the disk to be relabelled in an empty drive. Enter: 
RL 


The system responds with: 
ENTER DISK-NAME OF DISK TO BE RELABELLED 


7. Enter the disk’s current name, as it appears when OL is issued. The system responds with: 
ENTER NEW DISK-NAME TO BE ASSIGNED TO THIS DISK 


8. Enter the new name to be associated with the disk. A disk name is up to seven alphanumeric 


characters long, beginning with a letter. The system updates the specified disk with with the 
new name and displays the message: 
END RL 


ENTER FUNCTION <BC, FE, IN, LD, OL, RF RL, RP, WS> 
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RP (Replace) 


The Replace (RP) command can be used to load new software into the system. 


It has the advantage over LD in that an RP can be done without removing other files from the system. 
The disadvantage is that version string checks are not done. 


The following system files can be replaced: 


SYSBOOTSTRAP 
SYSDSCP 
SYSMCP!1 
SYSMCP2 
SYSWARMSTART 
SYSHOSTLOAD 
SYSICP 
SYSMPLII 
SYSTRANSLATE 
SYS-SUPERUTL 
SYSCOBOL 
SYSCONFIG 
SYSLANGUAGE 
COPY 
SYSCOLDSTART 
SYSBLAISE 
SYSBNACP 
SYSSNACP 
SYSINITBOOT 


1. To use RP, follow the basic COLDSTART procedures and enter RP when the ENTER FUNC- 
TION <BC, FE, IN, LD, OL, RF, RL, RP, WS> message appears. The new B900RL1 disk 
must be used to COLDSTART. The system responds with 

ENTER DISK-NAME OF DISK ON WHICH TO REPLACE FILES 


2. The disk name may be one to seven alphanumeric characters long, beginning with a letter. SYS- 
PACK is the disk name for the fixed disk. 


The Replace function uses the system files listed above from the release disk to replace the copies of 
these files on the specified disk. If an error occurs, the Replace terminates and any replacement files 
which have been loaded are deleted. This returns the disk on which the Replace was being performed 
to its original state. 


The function lists all files which have been replaced, and notifies the user when the Replace function 
finishes successfully, by the message: 


END RP 
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WS (Warmstart) 


This command allows the operator to warmstart the system directly from the COLDSTART operation. 
In general, an operator performs all desired COLDSTART functions (such as initializing a number of 
disks), then enters WS to prepare the system to begin regular daily work. 


This function begins by alerting the operator to set the SYSTEM/REMOVABLE switch to SYSTEM 


ra 
by issuing the message: 


SET SYSTEM/ REM SWITCH TO SYSTEM 


Once the switch is set, the message: 

EOj COLDSTART 
appears and the warmstart procedure begins and requests the date and time. Enter DT followed by 
the date and time. 


Example: 
DT 01/06/83 1010 
The disks that are on-line are then displayed. 


Warmstart is finished when the MCP version appears on the SPO. 
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COLDSTART Attended Mode — No SPO Present 


The COLDSTART routine for systems without a SPO may be performed through the hexadecimal dis- 
play and the keypad to allow execution of individual COLDSTART functions. 


Tables 9-5 to 9-11 list the sequences of displays and inputs that follow the status of each of these func- 
tions. A description of each function’s capabilities has already been given. 


Follow steps 1 to 3 of the normal procedure for COLDSTART Initiation. The system is ready for a 
function to be entered when an 80 appears in Bank D. 


Table 9-5 shows the sequence of indicator displays and keypad inputs which follow the status of the 
binary copy in keypad attended operation. 


Table 9-5. Keypad Attended Operation — Binary Copy 


Display: 80 in Bank D Enter function. 


Key in: 50 Selects binary copy function. 
Display: 40 in Bank A Binary copy function selected. 
50 in Bank D Enter disk number of target disk. 
10 in bank E 
00 in Bank F 
Key in: < 00-0F > 00 specifies drive A; 01 specifies drive B, and so on. 
Display: 52 in Bank D Enter disk number of source disk. 
Key in: <00-0F > 00 specifies drive A, 01 specifies drive B, and so on. 
Display: 53 in Bank D Updating track zero. 
Display: 54 in Bank D Copying source disk to target disk. 


Display: 55 in Bank D Verifying target disk parity. 


NOTE 
During the copy and verify display, Banks G and H will show the two High 
Order bytes of the disk sector address of the sector currently being read. 


The target disk will always be assigned the same disk name as the source disk 
in keypad attended mode, as there is no way to enter the pack-id through 
the key pad. 


Refer to COLDSTART Messages in COLDSTART Functional Description for error codes displayed 
in Bank A and corresponding messages. 


Table 9-6 shows the sequence of indicator displays and keypad inputs which cause an FE INITIALIZE 
during keypad attended operation. 


Table 9-6. Keypad Attended Operation — FE Initialize 


Display: 80 in Bank D Enter function. 
Key in: 70 Selects FE Initialize function. 


Display: 40 in Bank A FE Initialize function. 


70 in Bank D Enter disk number of disk to be FE initialized. 
10 in Bank E 
00 in Bank F 
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Table 9-6. Keypad Attended Operation — FE Initialize 
(continued) 


00 specifies physical drive A, 01 — drive B, 02 = drive 
C, and so on. 


<00-0F > 


Key in: 


Display: 40 in Bank A nn is the number of disks being FE initialized. 
| nn in Bank C | Bank D increments 71-7B as initialization steps are 
7i in Bank D performed. 
00 in Bank E | 


nn in Bank F 


Banks G and H will increment showing disk addresses | 
| | being write/read tested. 


The function is complete when an 80 returns to Bank D. This is a request for a new function. 


Table 9-7 shows the sequence of indicator displays and keypad inputs which cause an Initialize during 
keypad attended operation. 


Table 9-7. Keypad Attended Operation — INITIALIZE 


Display: 80 in Bank D Enter function. 


Key in: 10 Selects Initialize function. 

40 in Bank A | Initialize function. 1 
10 in Bank D Enter the drive number of the disk to be initialized. 
10 in Bank E 
00 in Bank F 
<00-0F > 


Display: 


00 specifies drive A, 01 specifies drive B and so on. Use 
FF for fixed disk assemblage. 


nn is the number of the disk being initialized. 
Bank D increments 11-1C as initialization steps are 
performed. 


Key in: 


40 in Bank A 
nn in Bank C 
12 in Bank D 
00 in Bank E 


Display: 


Banks G and H will increment, showing the disk address 
being write/read tested. 


The function is complete when an 80 returns to Bank D. This is a request for a new function. 


Table 9-8 shows the sequence of indicator displays and keypad inputs which cause a Load during key- 
pad attended operation. 


Table 9-8. Keypad Attended Operation — LOAD 


Display: 80 in Bank D Enter function. 
Key in: 20 Selects Load function. 


Display: 40 in Bank A Load function. 
20 in Bank D Enter drive number of disk to be loaded to. 


10 in Bank E 
00 in Bank F 
Key in: <00-0F > 00 specifies drive A, 01 specifies drive B and so on. Use 
FF for system psuedo-pack. 
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Table 9-8. Keypad Attended Operation — LOAD 


80 in Bank A 
21 in Bank D 
10 in Bank E 
00 in Bank F 
<00 or FF> 


(continued) 


nn is the number of the disk being loaded to. 


Bank G will increment from 0 as each file is loaded. 
When all files have been loaded from the release disk: 


Enter 00 to exit or bring the next release disk on line and 
enter FF to continue. 


Table 9-9 shows the sequence of indicator displays and keypad inputs which cause a Reformat during 
keypad attended operation. 


Display: 
Key in: 


Display: 


Key in: 


Display: 


Table 9-9. Keypad Attended Operation — REFORMAT 


80 in Bank D 
30 


40 in Bank A 
30 in Bank D 
10 in Bank E 
00 in Bank F 
<00-0F > 


40 in Bank A 
nn in Bank C 
30 in Bank D 
00 in Bank E 
nn in Bank F 


Enter function. 
Selects Reformat function. 


Reformat function. 
Enter drive number of the disk to be reformatted. 


00 specifies drive A, 01 specifies drive B, and so on. Use 
FF for fixed-disk assemblage. 


nn is the number of the disk being reformatted. 
Bank D increments 31-3C as reformatting steps are 
performed. 


The function is complete when an 80 returns to Bank D. This is a request for a new function. 


Table 9-10 shows the sequence of indicator displays and keypad inputs which cause a Replace during 
keypad attended operation. 


Display: 
Key in: 


Display: 


Key in: 


Table 9-10. Keypad Attended Operation — REPLACE 


80 in Bank D 
90 


40 in Bank A 
90 in Bank D 
10 in Bank E 
00 in Bank F 
<00-0F > 


Enter function. 
Selects Replace function. 


Replace function. 
Enter drive number of the disk on which Replace will be 
performed. 


00 specifies drive A, 01 specifies drive B and so on. Use 
FF for the system pseudo-pack. 
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Table 9-10. Keypad Attended Operation — REPLACE 
(continued) 
Display: 40 in Bank A nn is the number of the disk on which the Replace is 
90 in Bank D being performed. 
00 in Bank E 
nn in Bank F 


| Bank G will increment from 0 as each file is replaced. | 
When all files have been replaced from the release disk: 


Display: 80 in Bank A Enter 00 to exit or bring the next release disk on-line and 
91 in Bank D enter FF to continue. 


| 10 in Bank E 
00 in Bank F | 


| Key in: | <00-0F > | 


Table 9-11 shows the sequence of indicator displays and keypad inputs which causes the system to 
WARMSTART during keypad attended operation. 


Table 9-11. Keypad Attended Operation — WARMSTART 


Display: 80 in Bank D Enter a function. 
Key in: Selects warmstart function. 


Display: 


This display will flash on and off until the SYSTEM/ 
REMOVABLE switch is set to SYSTEM. At this time, the 
system will warmstart. 


COLDSTART —- Operator Unattended Mode 


The system automatically enters COLDSTART unattended mode when there is no SPO on the system, 
or when the COLDSTART operation detects that the NORMAL/EXTENDED switch is set to EX- 
TENDED. In unattended mode, any one of a series of functions may be executed. However, individual 
functions may not be selected. For example, one series of functions is Initialize, Load, Warmstart. In 
COLDSTART unattended mode, the user may not run the Initialize function alone because all three 


functions will be executed automatically. The individual functions are the same as those implemented 
in COLDSTART attended mode. There are two series of functions which the operator may select: 


1. INITIALIZE, LOAD and WARMSTART 
2. REPLACE and WARMSTART 


The system decides which set of functions to perform by checking the switch settings on the control 
panel. If the system detects that the SYSTEM/REMOVABLE switch is in the “SYSTEM” position, 
WARMSTART is initiated. If ‘““REMOVABLE”’ is detected, COLDSTART will then examine the 
NORMAL/EXTENDED switch. If the “NORMAL”’ position is set, the system will expect input from 
the SPO or keypad. The ‘““EXTENDED”’ position forces examination of the STANDARD/RECONFIG 
switch to decide which set of functions is to be executed. When the functions are completed, COLD- 
START signals the user to set the control panel switches in their primary positions (SYSTEM, STAND- 
ARD, DSKPRCI, OSPRC1, NORMAL, OPERATE) so that WARMSTART can proceed. See figure 
9-4 for a description of switch settings and their corresponding functions. 
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SYSTEM REMOVABLE 


WARMSTART 


SYSTEM/ 
REMOVABLE 
NORMAL/ 
EXTENDED 


STANDARD 


REPLACE 
WARMSTART 


NORMAL 


EXTENDED 


STANDARD/ 
RECONFIG 


INPUT FROM 
SPO OR 
KEYPAD 


RECONFIG 


INITIALIZE 


WARMSTART 


Figure 9-4. COLDSTART Switch Settings 


INITIALIZE, LOAD, WARMSTART 


In unattended mode the INITIALIZE/LOAD/WARMSTART series of functions is initiated when the 
user puts a B9OORL1 disk in the loader channel and sets/presses the following system switches: 


1. Set SYSTEM/REMOVABLE switch to REMOVABLE. 
2. Set NORMAL/EXTENDED switch to EXTENDED. 
3. Set STANDARD/RECOMFIG switch to RECONFIG. 
4. Press ON/CLEAR. 


The INITIALIZE/LOAD functions act on the fastest disk device available to the system (usually fixed 
disk). If the user wishes to perform these functions on any device other than the fixed disk, the fixed 
disk must be physically powered down or it will be initialized. 


After the release disk has been inserted and the control panel switches set, the system begins the Initial- 
ize function. All the necessary information, such as the number of files allowed, serial number, pack 
name, and owners-id are derived from default values. The user will be kept “‘informed’’ of the COLD- 
START function in progress and its status via display banks A and D. Bank A will contain a code 
reflecting COLDSTART status and bank D will contain a code indicating the current COLDSTART 
function in progress. 


After the Initialize function is complete, control is automatically passed to the Load function; when 
the Load function is complete, control is automatically passed to WARMSTART. 
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Bank D will contain @10@-@18@ during the Initialize function, @20@ during the Load function and 
@50@ during the WARMSTART function. After COLDSTART has loaded the system files from a 
release disk, COLDSTART will notify the operator by flashing the hexadecimal display on and off. 
This indicates user intervention is needed. Now the user has the option of inserting the next release 
disk to continue the Load function, or of setting the SYSTEM/REMOVABLE switch to SYSTEM so 
WARMSTART can take control. 


tended mode, no check is made for the presence of all required system files. If any 


a 
are absent, WARMSTART will not operate. 
REPLACE, WARMSTART 


In unattended mode, the REPLACE/WARMSTART series of functions is initiated when the user puts 
a BOOORLI disk in the loader channel and sets/presses the following switches: 


1. Set the SYSTEM/REMOVABLE switch to REMOVABLE. 
2. Set the NORMAL/EXTENDED switch to EXTENDED. 
3. Set the STANDARD/RECOMFIG switch to STANDARD. 
4. Press the ON/CLEAR switch. 


As in operator attended mode, the Replace function is used to replace certain files on a previously 
created disk. Replace does not perform version string checks. COLDSTART will execute the RE- 
PLACE/WARMSTART functions on the fastest speed device available to the system. If any load error 
occurs, the Replace function terminates and whatever replacement files have been loaded are removed. 
This returns ihe disk to its original state. COLDSTART will display any errors encountered during the 
Patch function on the hex display. When the Replace function completes, COLDSTART will flash the 
hex display on and off to indicate that WARMSTART is ready to take control. The operator should: 


1. Remove the B9OORL1 release disk. 

2. Set the NORMAL/EXTENDED switch to NORMAL. 

3. Set the STANDARD/RECOMFIG switch to STANDARD. 
4. Set the SYSTEM/REMOVABLE switch to SYSTEM. 


After step 4 is complete, WARMSTART is initiated automatically. 
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POWER OFF 


The system must be powered off in two steps: 


1. Logical power off 
2. Physical power off. 


The system is logically powered off by entering: 
PO SYSTEM (if there are no jobs in the mix) 


If there are jobs running and PO SYSTEM has been entered, PO FINAL may be entered to DS the 
jobs and bring the system down. 


The system responds with: 

SYSTEM HAS BEEN POWERED DOWN 
or whatever sign-off message has been entered in the SYSCONFIG file (using the CONFIGURER util- 
ity). 


The system can now be physically powered off. Power off should be done in the following order: 


1. All peripherals (such as line printer, cartridge drives, tape drives) 

2. Fixed disk unit (if present) 

3. Disk pack drives and disk pack controller (if present). Do not remove cartridges until red light 
comes on. 

4. SPO 

5. Processor. 
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TAKING SYSTEM DUMPS 


During the processing of daily work, system and/or memory failures may occur. When they do, a 
dump of the contents of memory should be taken so the problem can be documented and subsequently 
corrected. A ‘‘dump”’ of memory writes the contents of memory to a file. 


There are three methods of taking a system dump: 


1. System memory dumps occur automatically when: 
1) A clearstart occurs 
2) A task processor (inside the physical unit) goes not-ready. 
3) The OPERATE/MEMDUMP switch is set to MEMDUMP. This automatic dump feature 
may be used when the system appears to be hung. 
2. The operator can take a system memory dump using the the command GT MD. 
3. Dumping instructions stored in Read Only Memory (ROM) can be used to take a system dump. 
This procedure is explained later in this subsection. 


Operating System Dumps Created Automatically 


A file designed to hold a dump is created automatically each time the system is warmstarted. The file 
is called SYSDMFILEnn (nn represents numbers between 00 and 05). 


When the system warmsiaris, it checks to scc if SYSMDFILE00 already exists. If file SYSDMFILE00 
is not present, this file is created and reserved for a future dump. If a dump is not taken, this empty 
file will be removed when the system is powered off. If a file names SYSDMFILEOO already exists, 
the system creates SYSDMFILEO! as the file which will hold a future dump. Up to six dump files 
may be on the system at any one time (SYSDMFILE00 through SYSDMFILE0S). 


If the system is warmstarted and six files are already on the system, a message 
SYSDMFILE NOT CREATED MAX NO EXCEEDED 
appears on the SPO. 


Warmstart continues with no problems. 


However, it is not recommended that the system is left in a condition where there is no space for a 
dump file creation. If the existing files are not needed, they can be removed with the RM command. 
If they are being kept for future reference, they should be copied to another medium and then removed 
from the system. Once space has been made for a dump file, the system must be re-warmstarted be- 
cause the system can only write into a dumpfile which was created at the last WARMSTART. 


NOTE 
If the operator shuts down the system in any order except the correct one, 
empty dump files may remain on the system instead of being removed auto- 
matically. These empty files will eventually be noticed at WARMSTART and 
all available dump files will be reported as filled. An LR of the dump files 
is a quick method of determining whether the files are empty or whether they 
contain useful information. 


If an automatic system dump is taken, messages indicating the file was opened and closed will appear 
on the SPO screen. 


If the system hangs or clearstarts and the operator does not see these messages, assume the system 
dump file was not created and set the OPERATE/MEMDUMP switch to MEMDUMP. 
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During the automatic dump, indicator banks A through D are used to display the current state of the 
dump process. Table 9-12 describes the displays and possible errors. 


Table 9-12. Automatic Dump Feature Messages 


A Bank 
Display 


Description 


The dump routine is locating the SYSMCP files and the SYSDMFILEnn. 
C Bank — @00@ 
D Bank — @00@ 


RAM memory is being dumped. 
C Bank ~— bus address 
D Bank — page address 


@03@ An operation is being performed with the data in “backing storage’ (the read/ 
write portion of SYSMCP). 
C Bank — @00@ 
D Bank — @01@ — read of backing store from SYSMCP 
@02@ —- write of backing store to SYSDMFILEnn 


@EI@ An error was encountered in locating a SYSMCP file or SYSDMFILEnn. |: 


| B Bank — @01@ —- a read error occurred in the first record of the dump 
file. 


@02@ — unable to locate a dump file on disk — suspect the 
creation of the dump file failed at the last warmstart. 
@03@ — the disk containing SYSMCP is not ready 
@04@ — the disk containing SYSDMFILE is not ready. 
C Bank — @00@ 
D Bank — @00@ 


@E2@ An error was encountered while RAM memory was being dumped. 

B Bank — @01@ — a read error occurred in the first record of the dump file. 
@02@ — unable to locate a dump file on disk — suspect the 

creation of the dump file failed at last warmstart.. 

@03@ — the disk containing SYSMCP is not ready 
@04@ — the disk containing SYSDMFILE is not ready 

C Bank — bus address 

D Bank — page address. 


An error was encountered while “backing store’? was being dumped. (Backing 

store is the read/write portion of SYSMCP.) 

B Bank — @01@ -— a read error occurred in the first record of the dump file. 
@02@ —- unable to locate a dump file on disk — suspect the 

creation of the dump file failed at the last warmstart. 

@03@ — the disk containing SYSMCP is not ready 
@04@ — the disk containing SYSDMFILE is not ready 

C Bank — @v00@ 

D Bank @01@ — read of backing store from SYSMCP 

@02@ - write of backing store to SYSDMFILEnn. 


Using GT MD 


The operator uses the GT MD command to create a dump when he/she feels there is something wrong 
with the way the system is running. This might occur if some job appears to be running for a 
particularly long time and may be in a loop, or if the system does not appear to be responding correct- 
ly. 

GT MD is explained in the Utilities and Intrinsics subsection. 
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Taking A ROM-Created Dump 


If setting the OPERATE/MEMDUMP switch to MEMDUMP does not generate a dump, a ROM 
dump may have to be taken. A limitation specific to the CP 9580 DL4 hardware does not support 


the ROM dump capability to a 5.25 in disk loader device. 
The procedure for taking a ROM memory dump is: 


1. Set the OPERATE/MEMDUMP switch to MEMDUMP. 


2. Press the ON/CLEAR switch. 


3. Insert a disk into the loader channel of the system (designated by the system configuration). 
The system will not acknowledge the disk. 


4. Remove the cover from the hex keypad. Using the hex keypad, press and hold the “‘S’’ key 
while separately pressing the ‘‘E’’ followed by the ‘‘D’’ key. 


5. After pressing the ‘‘D’’ key, make a note of the contents of bank ‘‘D’’. If bank ‘‘D’’ contains 
a @00@, then proceed to the paragraph entitled ‘‘Multiple Disk Option’’. Otherwise continue 


to step 6. 


pena Gh nd hold the “S? key and then the ‘‘F” key. This step initiates the memory dump pro- 


. FIGSS ali ui us Bases Lasts 
cess. The hex display during execution of the dump will be: 
A and B Banks = Memory Address 
D1 = Bus Address 
D2 = Page Address 
E and F Banks = Disk Sector Address 
If the display stops changing, the code in the D bank is used as an index into the ROM Dump 


Error Messages. 


CN 


7. The ROM dump is complete when the hexadecimal display is blank. Note that this may take 
15 to 45 minutes. 


8. If the ROM dump terminates with a @12@ in bank D, the ROM dump has run out of disk 
space. This particular system does not have the ability to continue the ROM dump on another 
disk. However, the disk you have should not be discarded as it contains useful information. 


9. The ROM dump file should now be converted using the ROMCONVERT utility. 


10. To return to regular operation, put the OPERAT: E/MEM DUMP switch back to OPERATE 
and push ON/CLEAR. This is followed by the standard warmstart procedure. 


Multiple Disk Operation 


The ROM dump may be continued on another disk if bank D contained @00@ when the ROM dump 
was initiated. The continuation procedure is as follows: 


1. Enter a one-digit bus address and a one-digit page address. The bus and page address that 
should be entered is ‘‘10’’. 
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2. Press and hold the ‘‘S’’ key and then the ‘“‘F”’ key. This step initiates the memory dump pro- 
cess. 


3. The ROM dump is complete when all hexadecimal displays are blank. (Go to step 12.) 


4. If the ROM dump terminates with a @12@ in bank D, the ROM dump has run out of disk 
space. To continue the ROM dump on another disk, follow steps 5 and 6. 


5. Note the values displayed in banks G and H. This information is the starting point to be en- 
tered for continuation of the dump. 


6. Press and hold the ‘‘S’’ key, then press the ‘‘B” key. 

7. Remove the full disk and replace it with a new one. 

8. Press and hold the ‘‘S’’ key, then press the ‘‘D”’ key. 

9. Enter the values as noted in step 5. (Leading zeros should not be included.) 
10. Press and hold the ‘‘S’’ key, then press the ‘“‘F’’ key. 

11. The ROM dump is complete when the hexadecimal display is completely blank. 


12. The ROM dump file should now be converted using the ROMCONVERT utility. 


NOTE 
A ROM dump overwrites any information on the disk to which it is written 
but does not overwrite the directory. As a result, if an LR is done of the 
dump disk, it will appear to have old information on it and not the dump, 
while the dump is actually present. To check the validity of the disk, the 
ROMANALYZER command can be entered. If dump file information ap- 
pears on the printer, the ROM dump was successful. 


Analyzing Dumps 


When dumps are produced, they are in hexadecimal format. To put the dumps in usable form, 
Burroughs supplies three utility programs: 


1. SYSANALYZER converts the hexadecimal dump information which results from a system 
dump into readable English so it is easier to examine. 


2. ROMCONVERT converts a ROM dump into a format that can be analyzed by the SYSANA- 
LYZER program. 


3. ROMANALYZER is a program which looks directly at all or part of a ROM dump and is 
a substitute for the SYSANALYZER program when a ROM dump cannot be converted. 


One additional utility, DUMPFILE.UTL, pertains to the dumping procedure. This command can be 
used to divide a dump file into a number of smaller files or to reconstruct a file that has previously 
been divided. 


The use of these utilities is explained in detail under Utilities and Intrinsics later in this section. 
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TAKING PROGRAM DUMPS 


Sometimes problems arise with individual programs. They may stop processing entirely (without going 
to end-of-job) or they may go on and on, apparently in a loop. 


If this happens, the operator may wish to dump the program using the DP command shown in section 
33 


The dumped program can then be analyzed using the ANALYZER command explained in Utilities and 
Intrinsics later in this section. 
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FUNCTIONAL DESCRIPTION OF SYSTEM STARTUP 


This subsection contains a functional description of procedures that the system follows every time the 
system is warmstarted or coldstarted. COLDSTART is a stand-alone utility whose primary function 
is to create and maintain a system disk and user disks. COLDSTART is not normally run as part of 
system operation. It is intended to be used when disk(s) and/or system software require maintenance. 
WARMSTART is a stand-alone utility whose primary function is to determine the system hardware 
and software configuration and pass control to the MCP (that is the Operating System). The MCP 
has the responsibility of co-ordinating all system resources and interface to the user. The MCP must 
be up and running before any COBOL, RPG, MPLII programs or system intrinsics can be executed 
on the system. 


Startup software consists of the following programs: 


. SYSTEM STARTUP READ-ONLY MEMORY (ROM) 
CMS TRACK ZERO BOOTSTRAP 
SYSTEM DEPENDENT BOOTSTRAP (SYSBOOTSTRAP) 


. SYSCOLDSTART 
SYSWARMSTART 


waw 2 RANLV ERS BREN 
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As soon as the system enters startup mode, the startup ROM routine (permanently resident in the sys- 
tem) takes control. It looks for a disk that is powered on and running. It loads the TRACK ZERO 
BOOTSTRAP from that disk into memory and starts executing the TRACK ZERO BOOTSTRAP 
code. 


The task of TRACK ZERO BOOTSTRAP is to find a disk that contains a valid CMS label and a 
file called SYSBOOTSTRAP. After both these conditions are met, the TRACK ZERO BOOTSTRAP 
code loads the SYSBOOTSTRAP file and starts its execution. 


NOTE 
Once SYSBOOTSTRAP starts to execute, its action depends on the setting 
of the SYSTEM/REMOVABLE switch. If this switch is set to SYSTEM, the 
SYSBOOTSTRAP program will load the WARMSTART utility. If the switch 
is set to REMOVABLE, it will load the COLDSTART utility from a disk 
labelled B9OORLI. 


Therefore, the operator is responsible for selecting whether the system will COLDSTART or WARM- 
START when it is put in startup mode by setting the SYSTEM/REMOVABLE switch appropriately. 


During startup, Bank A of the hexadecimal display lights will indicate which startup software is in op- 
eration. Bank A will indicate the status of the program’s execution. To identify the startup program 
currently in control, refer to table 9-13. 


Table 9-13. Bank A Hex Displays for Startup Programs 


Value Range (Bank A) Program Executing 


@00@-@1F@ SYSTEM STARTUP ROM 
@20@-@2F@ TRACK ZERO BOOTSTRAP 
@30@-@3F@ SYSBOOTSTRAP 


40@-@9F@ SYSCOLDSTART 


@ 
| @A0@-@FF@ | SYSWARMSTART | 
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B 900/CP 9500 Bootstraps 


TRACK ZERO BOOTSTRAP receives control directly from the startup ROM routine. Its responsibility 
is to locate, load and pass control to the SYSBOOTSTRAP program. 


It searches the various disks on the system for the disk which contains the SYSBOOTSTRAP. This 
disk must be ready and have a valid CMS disk label. 


NOTE 
When warmstarting or coldstarting B 920/CP 9570 or CP 9500-2 systems 
with disk pack, a disk other than disk pack must be on-line and have a valid 
3.05 TRACK ZERO BOOTSTRAP. 


SYSBOOTSTRAP (the system dependent bootstrap) is loaded by and receives control from TRACK 
ZERO BOOTSTRAP. 


SYSBOOTSTRAP is responsible for: 
1. Checking the system Random Access Memory (RAM). 


2. Locating the disk which contains the COLDSTART/WARMSTART utilities, the system soft- 
ware file, SYSDSCP (disk processor code) and file SYSHOSTLOAD if a B 9387 disk pack drive 
is on-line. 


3. Loading COLDSTART or WARMSTART (depending on the setting of the SYSTEM/REMOV- 
ABLE switch) and SYSDSCP into the B 900/CP 9500. 


4. Loading the B 9387 Disk Pack Drive Controller (DPDC) with the file, SYSHOSTLOAD, if the 
B 9387 DPDC is on-line. 


5. Passing control to COLDSTART or WARMSTART. 


The COLDSTART/WARMSTART disk is one which is found by SYSBOOTSTRAP to be ready, to 
have a valid CMS disk label and to contain the required system files. 


SYSBOOTSTRAP uses the same method of searching for the COLDSTART/WARMSTART disk as 
was used to find the SYSBOOTSTRAP disk. The search sequence is as follows: from the fastest disk 
device to the slowest, from the highest I/O channel to the lowest, with each channel being searched 
from the lowest disk drive to the highest. 


To load and execute the stand-alone utility COLDSTART, the disk must have a pack-id of B9OORL1 
and contain the system files SYSCOLDSTART and SYSDSCP. If the B 9387 DPDC is on-line, the 
B9OORL1 disk must also contain the file SYSHOSTLOAD. 


To load the stand-alone utility WARMSTART, the required system files are SYSWARMSTART and 
SYSDSCP. If a fixed disk exists on the system, the two files (SYSDSCP and SYSWARMSTART) need 
not reside on the same fixed disk drive, as long as both are on fixed disk. When no fixed disk is pres- 
ent, both required files must reside on the same removable disk. Also, if the B 9387 DPDC is on-line, 
the WARMSTART disk must also contain the system file, SYSHOSTLOAD. The search sequence is 
as follows: from the fastest disk device to the slowest, from the highest I/O channel to the lowest, 
with each channel being searched from the lowest disk drive to the highest. 


Table 9-13 shows the format of the hex display during TRACK ZERO BOOTSTRAP and SYSBOOT- 
STRAP execution. The primary status of TRACK ZERO BOOTSTRAP and SYSBOOTSTRAP execu- 
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tion can be determined by the value appearing in bank A. Banks B to H contain additional information 
on TRACK ZERO BOOTSTRAP and SYSBOOTSTRAP status. For details of the identifiers found 
in banks B to H of table 9-13 refer to tables 9-14 and 9-15. 


Table 9-14. TRACK ZERO BOOT Error Displays 


A Bank Description 
Display 


@20@ NORMAL EXECUTION — NO ERRORS TRACK 0 BOOT is searching for a 
SYSBOOTSTRAP: 

C Bank = Most digit = channel, Least digit = drive 

D Bank = disk drive id 


Disk operation outstanding: 
B Bank = disk operation being performed — 
@80@ = read, @20@ = search on key, @10@ read drive id 
C Bank = most digit = channel, least digit = drive 
D Bank = drive id read 
E through H Bank = disk IOC status. 


Invalid disk operation length: 
B Bank = disk operation being performed — 
@80@ = read, @20@ = search on key, @10@ read drive id 
C Bank = most digit = channel, least digit = drive 
D Bank = drive id read 
E through H Bank = disk IOC status 


@23@ Invalid disk drive id: 
B Bank = disk operation being performed — 
@80@ = read, @20@ = read, @20@ = search on key, @10@ read drive id 
C Bank = most digit = channel, least digit = drive 
D Bank = drive id read 
E through H Bank = disk IOC status 


| 
Invalid channel: 
B Bank = disk operation being performed — 
@80@ = read, @20@ = search on key, @10@ read drive id 


C Bank = most digit = channel, least digit = drive 
D Bank = drive id read 
E through H Bank = disk IOC status 


Disk drive went not ready: 
B Bank = disk operation being performed — 
@80@ = read, @20@ = search on key, @10@ read drive id 
C Bank = most digit = channel, least digit = drive 
D Bank = drive id read 
E through H Bank = disk IOC status 


Disk device error: 
B Bank = disk operation being performed — 
@80@ = read, @20@ = search on key, @10@ read drive id 
C Bank = most digit, = channel, least digit = drive 
D Bank = Drive id read 
E through H Bank = Disk IOC status 


Key search failure: 
B Bank = disk operation being performed — 


Table 9-14. TRACK ZERO BOOT Error Displays 
(continued) 


A Bank Description 
Display 


= read, @20@ = search on key, @10@ read drive id 
Bank = most digit = channel, least digit = drive 
rive id read 


— 


| 
| 
Disk drive invalid: 
B Bank = disk operation being performed — 

@80@ = read, @20@ = search on key, @10@ read drive id 
| | C Bank = most digit = channel, least digit = drive | 

D Bank = drive id read 
| E through H Bank = disk IOC status 


No SYSBOOTSTRAP can be found. 
Note: a valid device error may have been detected on an otherwise valid disk. 
Ensure that the startup disk drive is ready. 


SYSBOOTSTRAP has loaded successfully and will take control. 


Table 9-15. SYSBOOTSTRAP Error Displays 


A Bank Description 


1 Display | H 
@30@ SYSBOOTSTRAP has gained control and is relocating itself: 
B Bank = 00 — SYSBOOTSTRAP is relocating itself in memory. 
E Bank = If not blank, the relocate could not complete, reason unknown. 
@31@ Memory check out is being performed: 


B Bank = @00@ — Disk processor memory 
@01@ -— SYSCOLDSTART/SYSWARMSTART MEMORY 
@02@ — COLDSTART/WARMSTART BUFFER MEMORY 
1 Bank = Bus address 
C 2 Bank = Page address 
E Bank = If not blank: check was unsuccessful, reason unknown. 


@32@ SYSBOOTSTRAP is performing a search for a file: 
B Bank = @00@ search for SYSWARMSTART or SYSCOLDSTART 
@01@ search for SYSDSCP 
= most digit = channel, least digit = drive 
D Bank = drive id read 


‘o) 


E bank 00 = search in progress 
01 = search successful 
02 = search unsuccessful 
@33@ SYSBOOTSTRAP is loading a file to memory: 
B Bank = 00 — SYSCOLDSTART or SYSWARMSTART is loading to OS 
processor 
01 — SYSDSCP is loading to disk processor 
C Bank = most digit = channel, least digit = drive 
E Bank = 00 — load in progress 


01 — load complete 
else — load failure; reason unknown 
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Table 9-15. SYSBOOTSTRAP Error Displays 
(continued) 


A Bank Description 
Display 


@34@ SYSHOSTLOAD loading: 
If C and E through H are blank 
B Bank = segment number being loaded 
D Bank = 01 = loading from disk to OS memory 
02 = transferring from memory to B 9387 
If C and E through H are not blank 
B Bank = most digit = 0, least digit = channel 
C Bank = ERROR 
29 = BAD IOC STATUS before segment transfer complete 
30 = BAD IOC STATUS after segment transfer complete 
31 = B 9387 returned bad result after transfer complete 
32 = B 9387 did not return result of a segment 
33 = B 9387 won’t enter segment load 
D Bank = segment number 
if E Bank = 3i 
E — H Banks = result descriptor sent by B 9387 else 
E Bank = IOC STATUS 
F — H Banks = decimal number of digits of the segment transferred. 


@3B@ Execution was interrupted by an unexpected REQ from an IOC: B Bank = 
request register 


@3C@ Disk exception condition: 
B Bank = disk operation being performed — 
@80@ = read, @20@ = séarch on key, @10@ read drive id 


C Bank = most digit = channel, least digit = drive 
D Bank = drive id read 
E Bank = 


@21@ — a disk operation was requested and has not yet completed 
@22@ an invalid disk operation length was requested 

@23@ - unrecognizable disk drive id 

@24@ — an invalid channel is being addressed 


@3D@ Device error: 
B Bank = disk operation being performed — @80@ = read, @20@ = search 
on key, @10@ read drive id 
C Bank = most digit = channel, least digit = drive, 
D Bank = drive id read 
E Bank = disk IOC status 


@3E@ SYSBOOTSTRAP has encountered a hardware detected error: 
B Bank = IC error status 

If data access 
C and D Banks 
E and F Banks 
G and H Banks 
If micro address 
C and D Banks = UMAR register 
E and F Banks = UMARX register 


M1 register 
MAX register 
M2 register 
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Tabie 9-15. SYSBOOTSTRAP Error Displays 
(continued) 


A Bank Description 


Display 


SBOOTSTRAP terminating: 

Bank = blank — normal termination 

00 — normal termination 

01 — cannot find OS processor 

| | 02 — cannot find a SYSCOLDSTART/SYSWARMSTART disk | 


03 — not able to set processor freeze on itself 
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WARMSTART FUNCTIONAL DESCRIPTION 


The WARMSTART utility starts up when the COLDSTART utility or SYSBOOTSTRAP passes con- 
trol to it, WARMSTART is responsible for: 


1. Determining the hardware configuration by associating each processor that it finds and its local 
memory size and the appropriate processor attribute (that is, Operating System, Task Processor, 
Data Comm Processor or Disk Processor). 

WARMSTART uses these attributes to verify the specifications found in the SYSCONFIG file 
and to load the proper system firmware files. 


2. Determining that all required system files are available by searching all ready disks on the sys- 
tem. The search proceeds from the fastest drive to the slowest. (The order is described in table 
9-13.) All required system files must be found to reside either entirely on the system fixed disk 
assemblage or entirely on a single removable disk. 


3. Assigning appropriate roles in the software system to each component of the hardware system 
as follows: 

1) If the user configuration specifications in the SYSCONFIG file are satisfied by the hardware 
currently available. WARMSTART configures the software system according to the SYS- 
COMFIG file. 

2) If the current hardware system cannot satisfy the user configuration specifications in the SYS- 
COMFIG file, or if the user has specified that WARMSTART is to use the default assign- 
ments, then WARMSTART will use the default configuration. (See Default Configuration, 
following.) 


4. Loading system firmware as required by the software system assignments. 


5. Passing control to the operating system (that is, the MCP). 
NOTE 

If the system disk has just been loaded with release software via COLD- 
START, then the version of SYSCONFIG that is used by WARMSTART is 
the version supplied on the release disk(s). If the CONFIGURER program 
has been executed since the last COLDSTART, the version of SYSCONFIG 
that is used by WARMSTART is that produced by the most recent execution 
of CONFIGURER. To restore the original release version to the system disk, 
do either a new COLDSTART replace or execute CONFIGURER with the 
proper parameters. 


Default Configuration 


The B 900/CP 9500 will WARMSTART using a ‘‘default configuration’’ if the specifications in the 
SYSCONFIG file conflict with the actual hardware configuration, or if the user has requested that de- 
fault values be used for those areas of SYSCONFIG that may default. 


The three areas that could cause the system to default are the Buffer Memory, Task Processor and 
Data Comm Processor assignments. Each of these areas is considered independent and only those areas 
with invalid requests will be assigned default values. 

Buffer Memory Defaults 


If a conflict arises between the amount of memory assigned in the SYSCONFIG file for buffer memory 
and the amount of memory available on the OS processor, then Buffer Memory will be assigned as 


follows: 
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Memory Pages on Total Buffer Data Comm Buffer 


OS Processor Memory Memory 

More than 4 80 K 40 K 
4 80 K 40 K 
3 64 K 32 K 
2 32 K 146K 


Task Processor Defaults 


If a conflict exists between the task processor assignments in the SYSCONFIG file and the task proces- 
sors actually available on the system, the following default configuration will be used: 


— all task processors with more than 128 KB of memory will be assigned all interpreters. 
— task processors with 128 XB of memory or less will be assigned one interpreter, alternating be- 
tween MPLII and COBOL. 


Data Comm Processor Defaults 


If a conflict arises between the Data Comm Processor (DCP) assignments in SYSCONFIG and the 
Data Comm Processors actually available on the system, WARMSTART will assign all the Data Comm 
Processors physically on the system as Data Comm Processors. The logical DCP numbers assigned to 
each processor will increase from zero, starting with the DCP at the highest bus address. 


To determine if the system has defaulted in any of these areas, the ‘“GT CF’’ command can be used 
to display the system configuration. This command is described under Utilities and Intrinsics. 


To tailor the SYSCONFIG file for specific configurations, the CONFIGURER program must be used. 
A repeat WARMSTART can then be done which will ioad the desired configuration. (The CONFI- 
GURER program is described under Utilities and Intrinsics.) 


WARMSTART has two ways of reporting its status to the operator. When a SPO is present on the 
system, WARMSTART attempts to direct messages to the SPO device. In both operator attended and 
unattended operation, WARMSTART uses the hexadecimal display to indicate the status of its execu- 
tion. During WARMSTART, Bank A is primary indicator of WARMSTART?’s progress through its 
code, while Banks B to H provide additional information on the status of WARMSTART. 


Table 9-16 outlines the contents and meanings of values appearing in the display banks during WARM- 
START. 
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Bank A 


Bank B 


Bank C 


@AIV@ 


@AI1@ 


@L2@ 
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Table 9-16. General Description of WARMSTART Messages 


Errors detected by WARMSTART are displayed in Bank A. WARMSTART errors 
can be broken down into the following ranges: 
Value Meaning 


@A0V@ NORMAL EXECUTION NO ERROR 
@A1@-@AF@ WARMSTART INTERNAL ERRORS 
@B0@-@BF@ SYSTEM ERROR 

@C0@-@CF@ HARDWARE ERROR 


Bank B contains a count of successfully executed logical operations. This bank has 
a maximum possible value of @FF@ (255 decimal). 


In the event of an error, this bank represents the last operation attempted during 
which an error occurred. (During normal operation, it is periodically updated to 
reflect the operation in progress.) The following table is a decode of the contents 
of bank C. 


Value Operation 
@0@ PROCESSOR INTERFACE CONTROL (PIC) COMMAND 
@W0@ LIST PERIPHERALS | 
@11@ LOCATE OS PERIPHERAL 
@12@ DETERMINE HARDWARE CONFIGURATION 
@13@ LIST REMOTE PERIPHERALS 
@14@ LOCATE SYSTEM DISK 
@20@ PRIME LOCAL DEVICE SOFTWARE CONTROLLER 
@21@ PRIME DISK PROCESSOR PARAMETERS 
@30@ ALLOCATE WARMSTART BUFFER MEMORY 
@31@ SYSTEM CONFIGURATION 
@40@ HANDLE DISK PROCESSOR CTM PREP 
@50@ MEMORY CHECKOUT — ATTACHED 
@si@ MEMORY CHECKOUT — UNATTACHED i 
@60@ PREPARE FIRMWARE SEGMENT LOAD 
@70@ LOAD FIRMWARE SEGMENT 
@72@ COMPLETE WARMSTART TABLE 
@80@ DISPLAY MESSAGE TO SPO 
@EO@ WARMSTART COMPLETE — PASS CONTROL TO OS 
Warmstart Error Displays 
Description 


Normal execution, no errors: 
B Bank — number of logical operations performed 
C Bank — operation in process 


Opcode not recognized: 

B Bank — number of logical operations performed. 
C Bank — operation in process 

E-F Bank — current offset 

G-H Bank — next offset 


Operation not completed successfully: 

B Bank — number of logical operations performed. 
C Bank — Operation in process 

E-F Bank — current offset 


G-H Bank — next offset | 


Table 9-16. General Description of WARMSTART Messages 
(continued) 


Description 


WARMSTART table entry not recognized 
B Bank — number of logical operation performed. 
| | C Bank — operation in process | 


@A8@ Invalid operation for selected device: 
B Bank — number of logical operations performed 
C Bank — operation in process 
D Bank — operation type: 
| . 00 = command, 01 = read, 02 = write, 03 = search 
E Bank — device’ type: 
1 


00 = disk, 01 = SPO, 02 = processor, 03 = memory 
F Bank — if disk: most digit = logical drive number or if processor memory: 
most digit = bus, least digit = page 
G, H Bank — device dependent parameters 


@AI@ Device not recognized 
B Bank — number of logical operations performed. 
C Bank — operation in process 
D Bank — operation type: 
00 = command, 01 = read, 02 = write, 03 = search, 
E Bank — device type: 
00 = disk 01 = SPO, 02= procesor, 03 = memory 
F Bank — if disk: most digit = logical drive number or if processor or memory: 
most digit = bus, least digit = page 
G, H Bank — device dependent parameters. 


@AA@ Invalid unit for this device: 
B Bank — number of logical operations performed. 
C Bank — operation in process 
D Bank — operation type 
00 = command, 01 = read, 02 = write, 03 = search 
E Bank — device type: 
00 = disk, 01 = SPO, 02 = processor, 03 = memory 
F Bank — if disk: most digit = logical drive number or if processor memory: 
most digit = bus, least digit = page 
G, H Bank — device dependent parameters 


@AB@ Source descriptor invalid — does not exist or exceeds physical attributes: 
B Bank — number of logical operations performed 
C Bank — operation in process 
D Bank — operation type 
00 = command, 01 = read, 02 = write, 03 = search 
E Bank — device type 
00 = disk, 01 = SPO, 02 = processor, 03 = memory 
F Bank — if disk: most digit = logical drive number or if processor memory: 
most digit = bus, least digit = page 
G, H bank — memory address or error 
@AC@ Destination descriptor invalid — does not exist or exceeds physical attributes: 


B Bank — number of logical operations performed 
C Bank — operation in process 
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Table 9-16. General Description of WARMSTART Messages 
(continued) 


Description 


D Bank — operation type: 
00 = command, 01 = read, 02 = write, 03 = search 
E Bank — device type: 
00 = disk, 01 = SPO, 02 = processor, 03 = memory 
F Bank — if disk: most digit = logical drive number or if processor memory: 
most digit = bus, least digit = page 
G, H Bank — memory address of error 


Device not on system 
B Bank — number of logical operations performed. 
C Bank — operation in process 
D bank — operation type: 
00 = command, 01 = read, 02 = write, 03 = search 
E Bank — device type: 
| 00 = disk, 01 = SPO, 02 = processor, 03 = memory | 
F Bank — if disk, most digit = logical drive number, or if processor or memory: 


most digit = bus, least digit = page 
G, H Bank — device dependent parameters 
System disk not found: 


B Bank — number of logical operations performed. 
C Bank — operation in process 


SYSCONFIG file error: 
B Bank — number of logical operations performed 
C Bank — operation in process 


@B0@ 


@B1@ 


B Bank — number of logical operations performed 

C Bank — operation in process 

D Bank — file being accessed: 

03 = SYSMCP, 04 = SYSICP, 05 = SYSDSCP, 06 = SYSMPLII, 07 = 
SYSCONFIG, 08 = SYSLANGUAGE, 09 = SYSTRANSLATE 

E Bank — segment type: 02,06,0A = resident code, 03 = resident data 


@B3@ Unable to load a firmware segment, exceeds memory attributes: 
B Bank — number of logical operations performed. 
C Bank — operation in process 
D Bank — processor type: 
01 = OS, 02 = DCP, 03 = task, 04 = disk, 05 = buffer 


@Ci@ Unable to access OS processor 
B Bank — number of logical operations performed. 
C Bank — operation in process 

@C3@ Insufficient memory to WARMSTART: 

B Bank — number of logical operations performed 

C Bank — operation in process 

ID in ROM invalid: 

B Bank — number of logical operations performed 

C Bank — operation in process 


I 
@B2@ Firmware segment noi found | 
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Table 9-16. General Description of WARMSTART Messages 
(continued) 


Description 


Device error: 

B Bank — number of logical operations performed 
C Bank — operation in process | 
D Bank — operation type: 

00 = command, 01 = read, 02 = write, 03 = search 

E Bank — poe type: 

00 = disk, 01 = OST, 02 = processor, 03 = memory 

F Bank — if disk: most significant digit = logical drive number, or if processor | 
or memory: most significant digit = bus, least significant digit = page 

G Bank — general status (see description for @C9@) H Bank — device error 
status (see description in @C9@) 


@CI@ Device not ready: 
B Bank — number of logical operations performed. 
C Bank — operation in process 
D Bank — operation type: 
00 = command, 01 = read, 02 = write, 03 = search 
E Bank — device type: 
00 = disk, 01 = SPO, 02 = processor, 03 = 


memo 
F Bank — if disk: most digit — logical drive number 


ii Gish: MCst Mapae Mawes eee? = 


most die bus, least digit = page 
G Bank — general status 

00 — controller error (internal to DP) 
01 — command successful 

02 — command unsuccessful 

03 — device error aborted command 
04 — not used 

05 — descriptor error 

H Bank — device error status 

00 — no error 

01 — seek timeout 

02 — head off cylinder 

03 — sequence error (internal to DP) 
04 — parity error 

05 — sector not found 

06 — illegal address 

07 — status word error 

08 — data error 
write inhibited 


Ty 
or, if nracessor or memory: H 


e 
is 
& 
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COLDSTART FUNCTIONAL DESCRIPTION 


COLDSTART is a stand-alone utility whose primary function is to create and maintain a system disk 
and user disks. COLDSTART operates in two distinct modes, Operator Attended Mode and Operator 
Unattended Mode. Both modes and their functions are discussed. Users should be aware of which 
mode of COLDSTART their system is operating under, as it is not selectable by the operator. COLD- 
START’s mode of operation is determined by the system hardware configuration. Basically, a system 
will operate in Operator Attended Mode if the system has a SPO, thus allowing COLDSTART to dis- 
play information to and request information from the operator via the SPO device. If a system does 
not have an SPO device, then COLDSTART will communicate with the operator via the hexadecimal 
keypad and display. Operator Unattended Mode refers to COLDSTART functions being performed ac- 
cording to the settings of the panel switches. Refer to paragraphs headed COLDSTART — Operator 
Unattended Mode. 


B 900/CP 9500 system software is distributed on release disk(s) labelled B9OORL1, B9O0ORL2 and so 
on. It is the user’s responsibility to maintain these disks with system software patches (fixes) which 
are distributed in the form of B 900/CP 9500 flashes. Users must update these disks to maintain their 
system and system disk. The maintenance of the release disks (that is, applying system software 
patches) is not a function of COLDSTART. The Field Patch Program (FPP) which runs under MCP 
controi is used to apply system software patches to the release disks. After patches have been applied 
to the release disks, a COLDSTART function may be used to replace the files on the system disk. 
The Field Patch Program is described in detail in this section under Utilities and Intrinsics. 


FE (Initialize MTR Disk) 


This function initializes a disk for Maintenance Test Routine (MTR) usage. Old disk contents are de- 
leted, the disk surface is qualified and a log in the disk label is set to indicate it is an MTR disk. 


Six specific tracks on any given MTR disk are reserved for use by MTR routines. This is done by set- 
ting ‘“Bad Sector’’ indicators in the disk’s non-file (available space) directory. If these six tracks are 
found to be bad at any location, MTR initialize terminates. Success of this function means that those 
six tracks are flawless and unconditionally reserved for MTR usage. 


The first request issued when the FE function has been selected is for identification of the MTR disk’s 
drive. The following message appears: 


ENTER DRIVE-ID OF DISK <3 CHARACTERS, SUCH AS “‘DKA’’> 
Respond with a three-letter drive mnemonic. 
Example: 
DMF denotes that the MTR disk is a mini disk, residing on drive F. 
A fixed disk (DF=) cannot be used as the MTR disk. 
The system’s next message is: 
VALUES FOR DISK-NAME, OWNER’S ID, SERIAL-NUMBER AND MAX-NUMBER-OF- 
FILES-ON-DISK MUST NOW BE ASSIGNED. DO YOU WISH TO ASSIGN THESE 
VALUES YOURSELF OR HAVE THE SYSTEM DO IT FOR YOU? 


ENTER ‘SELF’? OR ‘‘SYSTEM”’ 
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If “SYSTEM’”’ is selected (default mode), all further information needed by FE initialize is derived 
from the default values. No further information is required from the operator. Refer to ‘““COLD- 
START DEFAULT ASSIGNMENT”? later in this section. 


If “‘“SELF’’ is selected, FE initialize will generate the disk directory and label using the information 
supplied to the following queries: 


ENTER DISK-NAME 


Enter the name of the disk being initialized for MTR usage. The name is selected by the operator and 
may be up to seven alphanumeric characters long, beginning with a letter. 


The system responds with: 
ENTER SERIAL-NUMBER 


Enter a serial number up to six digits long which may be chosen at random if there is no need to 
keep a record of MTR disk serial numbers. 


The system now requests the owner’s id via the message: 
ENTER OWNER’S-ID 
This id name may be from 1 to 14 alphanumeric characters long. 
The next information required is the maximum number of files to be allowed on the disk. 
ENTER MAX-NUMBER-OF-FILES-ON-DISK 
The possible range is from 1 to 2804 files. 
Bad sectors within the six tracks reserved for usage by the MTR will cause failure of the FE initialize 
and the message ‘‘BAD MTR TRACK”? to be displayed. Other tracks, which will later contain MTR 
software, are allowed up to a total of 50 bad sectors. The message reported to the user is: 
TRACK # <number> BAD FOR <number> SECTOR(G) 
When FE initialize ends successfully, the following message is displayed. 
END FE 
Increasing an Existing Fixed Disk Assemblage 
All fixed disk drives on a B 900/CP 9500 system that are powered on and ready at COLDSTART 
initialize time are initialized as a single fixed disk assemblage. A procedure is available for adding one 
or more fixed disk drive units to an existing fixed disk assemblage without having to re-initialize the 
existing assemblage. The process is outlined in the following procedure: 


1. Bring the system up under COLDSTART control. 


2. Power off all fixed disk drives that are not to be initialized. This is to protect the files on these 
units from erasure by the initialize function. 


3. Power on the fixed disk drive(s) that are being added to the fixed disk assemblage. 
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4. Use the initialize function to initialize the drive(s) to be added. Specify the same number of 
files as those specified on the original assemblage. A unique label will be requested for each 
drive initialized. ; 


5. After the initialize function terminates normally, restore power to all fixed disk units. 


6. Rewarmstart the system by following the WARMSTART procedure described under WARM- 
START. 


The MCP will automatically add the new drives to the fixed disk assemblage once the system has been 
warmstarted. 


NOTE 
When adding one or more drives into an existing fixed disk assemblage, the 
additional drives must be placed in an available slot or channel, higher than 
any other channel which is being used or which was used. When replacing 
a disk or channel on the system, the new disk must be cabled into the same 
channel from which the old disk was removed. It also must be given the same 
packid and initialization parameters. 


This procedure has not been qualified for 211 disks. 
COLDSTART Disk Selection 


All disks have been assigned priority according to their speed. The fastest disk device is the fixed disk, 
followed by disk pack, cartridge disk, then mini disk. 


In Operator Attended Mode, the operator may select which drive/disk the desired COLDSTART func- 
tion is to act upon. In Operator Unattended Mode, COLDSTART searches for the highest priority de- 
vice because the operator cannot make specific requests to COLDSTART. 


COLDSTART Default Assignments 


The FE, IN and RF functions of COLDSTART allow the operator the option of assigning his own 

disk attributes, or defaulting to predetermined values. The default values are always used in COLD- 

START Operator Unattended Mode. In the COLDSTART Operator Attended Mode, the message 
ENTER ‘“‘SELF’’ OR ‘‘SYSTEM’’ 

is displayed on the SPO. If ‘““SYSTEM”’ is entered, the system will assign the number of files to be 

allowed on disk, serial number, packid and owner-id as shown in table 9-17. 


Table 9-17. Disk Attribute Default Values for IN, FE and RF Functions 


Information Needed Removable Disk Defaults | Fixed Disk Defaults 


Number of files to be allowed on system disk. 256 ** 2805 ** 


Serial number of disk used as system disk. 000000 000000 
(EBCDIC) (EBCDIC) 

Packid of disk used as system disk OO0000A *** 000000 1* 
(ASCID) (ASCID 


Owner-id of disk “‘Removable disk’’ ‘Fixed disk’’ 
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Table 9-17. Disk Attribute Default Values for IN, FE and RF Functions 
(continued) 


: If there is more than one fixed disk, the first has the packid as shown; each additional 
disk packid is incremented by }. 

<7 2805/256 includes the SYSMEM file. 2804/255 is the actual number of user files which 
can reside on the disk. 


“<A”? is the third letter of the device mnemonic. For example, DMB would get 000000B. 


COLDSTART primarily uses banks A and D to indicate its status. Bank A is used to display a code 
which corresponds to COLDSTART’s status or an error message. A list of codes appearing in bank 
A and messages appearing on the SPO during COLDSTART is shown in table 9-18. 

COLDSTART Messages 

COLDSTART Error Displays 

The function being performed is shown in bank D and defined in table 9-19. 


Table 9-18. COLDSTART Error Displays 


A Bank Description 
Display . 


@40@ NO ERROR — normal operation. 

@41@ ERROR ON TRACK ZERO — an attempt was made to initialize a disk that has 
a bad sector on Track 0 (Track 0 is required to be good). 

@42@ ERROR ON MTR TRACK -— an address required for an FE track has a bad 
sector. 

@8B@ UNABLE TO ALLOCATE DIRECTORY SPACE — there are not enough 
contiguous good sectors for the disk directory size chosen within the area to which 
the B 900 assigns directories. 

@4@ TOO MANY BAD SECTORS — an attempt was made to initialize a disk that 
has more than 50 bad sectors. 

@45@ UNABLE TO INITIALIZE CYLINDER ON DISK PACK — the initialize or 
reformat function encountered a disk error. 

@46@ AVR — invalid disk label found while initialize function was attempting to replace 
track 0 and bootstrap. 

@47@ UNABLE TO READ AVAILABLE TABLE — initialize or reformat function 
encountered error on source available table. 

@48@ AVR — invalid disk label was found while the initialize function was rebuilding 
the available table. 

@49@ RELOCATE — unable to decode address while initializing. 

@4B@ DEVICE ERROR — BAD TRACK ZERO - an attempt was made to initialize a 
disk that has a bad sector on Track 0. 
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Table 9-18. COLDSTART Error Displays 
(continued) 


A Bank ee 
Description 


UNABLE TO WRITE SECTOR ADDRESSES — error encountered on destination 
disk by initialize or reformat function. 


UNABLE TO WRITE AVAILABLE TABLE — error encountered on destination 
disk by initialize or reformat function. 

UNABLE TO WRITE TRACK 0 BOOTSTRAP -— error encountered on 
destination disk by initialize or reformat function. 


UNABLE TO WRITE DISK FILE HEADERS — error encountered on destination 
disk by initialize or reformat function. 


@50@ UNABLE TO WRITE DISK FILE NAME LIST — error encountered on 
destination disk by initialize or reformat function. 
@51@ UNABLE TO WRITE PPIT — error encountered on destination disk by initialize | 


or reformat function. 


@52@ AVR — invalid label encountered while initialize function attempting to write 
SYSMEM header. 

@53@ UNABLE TO WRITE SYSMEMFILE — error encountered on destination disk by 
initialize function. 

@54@ UNABLE TO WRITE LABEL — relabel function encountered error on 
destination disk. 

@55@ UNABLE TO LOCATE PPIT ENTRY — relabel function encountered error on 
source disk. | 

@56@ UNABLE TO WRITE PPIT ENTRY — relabel function encountered error on 
destination disk. 

@57@ SYSINITBOOT NOT STORED IN MEMORY — COLDSTART cannot find 
B900RL1/SYSINITBOOT 

@59@ UNABLE TO READ DISK FILE HEADERS — disk processor encountered error. 


@5A@ SYSINITBOOT NOT STORED IN MEMORY ~— see @57@ 
@S5B@ SYSINITBOOT NOT STORED IN MEMORY ~— see @57@. 
@5F@ UNABLE TO READ PPIT — disk processor encountered error processing source 


disk. 

@60@ CONFLICTING PPITS — the PPITs found are not identical on all fixed disk 
drives. 

@61@ CONFLICTING PPITS — see @60@. 

@62@ UNABLE TO WRITE PPIT — disk processor encountered error processing 


destination disk. 
@63@ UNABLE TO WRITE PPIT — see @62@. 
@64@ CONFLICTING PPITS — see @60@. 
CONFLICTING PPITS — see @60@. 


Table 9-18. COLDSTART Error Displays 
(continued) 


Description 


AVR — invalid label encountered by load or replace function while building file 
list. 

@68@ FILE AREA SIZE TOO LARGE — COLDSTART encountered a file with an 
area larger than 65535 sectors. 

@69@ UNABLE TO REMOVE FILE AREAS - the load or replace function 
encountered error on destination disk. 

@6A@ DISK ALREADY CONTAINS FILES — the LD function has detected that the 
disk is not properly initialized or reformatted. 

@6B@ UNABLE TO READ DISK FILE NAME LIST -— load or replace function 
encountered error on source disk. 

@6C@ UNABLE TO WRITE DISK FILE HEADER -— load or replace function 
encountered error on destination disk. 

@6D@ UNABLE TO ALLOCATE FILE AREA -— load or replace function encountered 
error on destination disk. 

@6E@ UNABLE TO WRITE DISK FILE HEADER — load function encountered error | 
on destination disk. 


@6F@ FILE NOT REPLACED — RP function terminated. 


@70@ UNABLE TO READ DISK FILE HEADER - replace function encountered error 
on source disk. 

@1@ UNABLE TO WRITE DISK FILE HEADER - replace function encountered 
error on destination disk. 

@72@ CHECK LOAD -— LD incomplete, all required system files were not loaded. 

@73@ INVALID DISK NUMBER — disk number was not FF or in range 00 through 
OF. 

@715@ INVALID SYSINITBOOT FILE — COLDSTART cannot find correct B900RLI1/ 
SYSINITBOOT file. 

@76@ DISK NOT READY — COLDSTART is trying to access a disk that is not on 
line. 

@77@ UNABLE TO DECODE ADDRESS — initialize function encountered error during 
address. 

@B@ POWER OFF FAILURE -— disk processor detected error while attempting to 
power off disk drive. 

@79@ NO FIXED DISKS ON LINE — fixed disk is not ready. 


@7A@ INVALID FUNCTION — an invalid function code was entered. 


@7TB@ DEFAULT PACK ALREADY PRESENT - a disk with the default name to be 
used is already on the system. 


AVR — disk is either write inhibited or has an invalid name. 
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A Bank 
Display 


@7D@ 


@85@ 


@86@ 
@87@ 


@8@ 


Table 9-18. COLDSTART Error Displays 
(continued) 


Description 


DRIVE NOT ON LINE - the specified disk drive is not on line. 
INVALID DEVICE TYPE - disk cannot be fixed or pack (DF or DP). 


NO SYSTEM PSEUDO PACK ONLINE ~ FF was entered but there is no 
system disk on line. 


DISK NOT ONLINE -— a disk ID of a not ready disk was entered; if the next 
release disk is required, bring it on line and enter FF to continue. 

MULTIPLE DISKS ONLINE WITH SAME NAME — duplicates are not allowed. 
SPECIFIED DISK NOT PERMITTED FOR LOAD OR REPLACE — Load/ 
Replace must be performed on the system pseudo-pack or a removable disk. 
FILE NOT LOADED -— an attempt was made to load an invalid file type. 
DISK NOT ONLINE —- B900RLi disk is required on ijine now. 

DISKS NOT COMPATIBLE -— binary copy requires the disks to be of the same 
type. 

READ ERROR ON TRACK ZERO — specified disk has bad sector on track 0. 
WRITE ERROR ON TRACK ZERO — specified disk has bad sector on track 
zero and cannot be written to. 

INPUT ERROR DURING COPY -— a read error occurred on source disk that 
could not be isolated to exact sector. 

INPUT ERROR DURING VERIFICATION — a read error occurred on target 
disk that could not be isolated to exact sector. 


ERRORS OCCURRED DURING COPY AND VERIFICATION — binary copy 
may have aborted. 


WRITE ERROR ON TARGET DISK -— target disk has disk error and cannot be 
written to. 


SOURCE AND TARGET ARE SAME DISK — the source and target disks 
specified reference the same disk; they must be separate. 


UNABLE TO INITIALIZE 211 DISK — initialize function encountered error 
attempting to initialize the fixed disk. 


During COLDSTART Bank D will contain a code reflecting the COLDSTART function currently oper- 
ating. The COLDSTART functions are outlined in table 9-19. This information should be used in con- 
junction with the information in table 9-18. 
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Table 9-19. COLDSTART Functions 


ENTER DATE -— system will accept date entry. 


ONLINE — list disks online. 


| 

@0F@ WARMSTART — system is warmstarting. 

@10@ INITIALIZE — enter disk name and parameters for initialize. 
| @11@ | INITIALIZE — write sector addresses. 

@12@ INITIALIZE — perform read/write tests. 

@13@ INITIALIZE — delete bad tracks. 

@14@ INITIALIZE — calculate directory size. 

@15@ INITIALIZE — write new label. 

@16@ INITIALIZE — write track zero bootstrap. 

@17@ INITIALIZE - tite non-file-directory (available table). 

@18@ INITIALIZE — write disk-file-header-list. 

@19@ | INITIALIZE — write disk-file-name-list. 

@\A@ INITIALIZE — write pseudo-pack identifier table (fixed-disks only). 

@1B@ INITIALIZE — write SYSMEM. 

@1C@ INITIALIZE — pseudo-pack identifier table fixup. 

@20@ LOAD -— enter disk-name for load function. 

@21@ LOAD — continue with next release disk or exit. 

@22@ LOAD -— build list. 

@23@ © LOAD — removing old file. 

@24@ LOAD -— load new file. 

@30@ REFORMAT — enter disk-name for replace function. 

@34@ REFORMAT -— calculate directory sizes. 

@35@ REFORMAT -— write new label. 

@36@ REFORMAT — write track 00 (label and track 0 bootstrap). 

@37@ REFORMAT — write non-file-directory (available table). 

@38@ REFORMAT — write disk-file-headers. 

@39@ REFORMAT -— write disk-file-name-list. 

@3A@ REFORMAT -— write pseudo-pack identifier. 

@3B@ REFORMAT — write SYSMEM. 

@3C@ REFORMAT — pseudo-pack identifier table fixup. 

@50@ BINARY COPY -— enter target disk-id for binary copy. 

BINARY COPY -— enter target disk-name. 


@51@ 
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Table 9-19. COLDSTART Functions 
(continued) 


Description 

Display 

BINARY COPY — enter source disk-id. 

BINARY COPY — update track 00. 

BINARY COPY -— copy. 

BINARY COPY -— verify. 

FE INITIALIZE — enter disk-name for FE initialization. 

FE INITIALIZE — write sector addresses. 

FE INITIALIZE — perform read/write tests. 

FE INITIALIZE — delete tracks. 

FE INITIALIZE — calculate directory sizes. 

FE INITIALIZE — write new label. | 

FE INITIALIZE — write track 0 bootstrap. 
| 
| 
| 


@77@ FE INITIALIZE — write non-file-directory (available table). 

@78@ FE INITIALIZE — write disk-file-header-list. 

@79@ FE INITIALIZE — write disk-file-name-list. 

@7A@ FE INITIALIZE — write pseudo-pack identifier table (fixed disk only). 


| 
@7B@ | FE INITIALIZE — create system entry. 
| IDLE LOOP — wait for next function to be entered. 
| REPLACE ~ enter disk-name for replace function. 
| REPLACE — continue with next release disk or exit. 
REPLACE — build list. 
REPLACE — remove old file. 
REPLACE -— copy new file. 
REPLACE — rename new file. 
REPLACE — replace bootstrap. 
RELABEL — enter disk-name for relabel function. 
RELABEL — update disk label. 


RELABEL — update pseudo-pack identifier table. 
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DUMPS FUNCTIONAL DESCRIPTION 
Read Only Memory (ROM) Dump Routine 


The ROM dump routine is a software debugging tool which resides in the system ROM. It is used 
when the MCP is unable to produce a system dump file for analysis by the System Dump Analyzer 
program (SYSANALYZER). It allows the dumping of all contents of system RAM, (Random Access 
Memory) to a CMS compatible removable disk. This disk must be in the loader I/O channel. 


Disk Format 


The data being dumped will be written onto the dump disk beginning at the first good sector after 
the directory. The dumped data skips across any bad sector(s) encountered during the dump process. 
If a bad sector is found, the first good sector after it is used. 


The dumping algorithm described in the previous paragraphs results in the overwriting of the contents 
of the files already on the disk. The disk directory is not updated to reflect this corruption. 


The system must first locate the dump disk and locate the end of the disk directory. 


Dumping begins in the first byte following the directory end address. If this would cause the dump 
to begin in a bad sector, however, the first byte of the next good sector is used. 
Data is dumped in 180-byte records. The first record contains a validity string, which indicates that 
the disk contains a ROM dump. The validity string is: 

B9D0PROMDUMP0.Q 


The first nine bytes of each page of memory dumped will contain a validity string of the following 
format: 

Bus address: one byte 

Page address: one byte 

Page size: two bytes 

Error status: one byte 

1C-Status 1: one byte 

IC-Status 2: one byte 

Next page: two bytes, disk sector address for start of dump of next page. 


The respective memory page contents, from its zero address to its limit, will be dumped immediately 
following its descriptor. The descriptor will start on a record boundary. Each memory page dumped 
will take up only the number of records necessary for it and its respective descriptor. 
The last record written by the ROM dump will be either: 
1. A terminator record, when the disk is able to contain a complete dump (that is, a dump consist- 
ing of the entire system RAM memory dump, the validity record and the terminator record) 
indicated by a blank display. 


or 


2. The last record that could be dumped for the current memory page, when an end of disk condi- 
tion occurred (indicated by 12 displayed in bank D). 


The terminator record, if written, consists of the following string: 
““B900PROMDUMPED” 
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ROM Dump Messages 


Hardware detected errors are handled by presenting error relevant information on the hexadecimal dis- 
plays in one of the following formats: 


- Bank D Bank Bank B Bank C Bank E Bank F Bank G Bank H 
A 


@08@, OFFSET --- STATUS ~——-— MAX REG 

@18@, 

@28@, 

@38@, 

@38@, 

@838@, 

@C8@, 

@FF@ 

@04@, --~ 0 =H --- --- 0 =H --- --- 

@10@-@13@ 

@01@-@03@ SECTOR ADDR -- DCPS DCSS --- -- 
Table 9-20 lists the meanings of error codes found in bank D of the hexadecimal display. For a decode 
of the identifiers and codes found in banks A-C and E-F refer to table 9-21 ROM Dump Display Refer- 
ence Table. 


Table 9-20. Bank D Error Codes 


Possible Causes Suggested Action 


08 Hardware detected memory error, Re-enter Dump-To-Display option as 
either a data read parity error or keypad will be enabled for entry of next 
memory limit occurred during an option (option idle state). 
execution of Dump-To-Display. | 

18 An error occurred during the setup System clear is necessary to restore the 
for, or execution of, the Dump-to- processor to a running state. 

Disk option. 

28 Dump routine could not find a page | Same action as @18@. 
in memory while dumping to disk. 

38 Dump routine failed while checking Same action as @18@. 
disk label prior to dumping to disk. 

58 A bad area was found on the dump } Same action as above. 
disk. 

88 Read after write error was detected Same action as @18@. 


after Dump-to-Disk was complete. 
C8 A write error was detected when Same action as @18@. 
dumping to disk. 


FF A fatal error. A hardware detected System clear is necessary. 
error has occurred which gives an 
unexpected error status. 
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Table 9-20. Bank D Error Codes 


(continued) 
Possible Causes Suggested Action 


The selected dump disk has gone | Restore dump disk to operation state. | 
from operational to non-operational. | Dump will automatically continue from | 


point of interruption. 

10 No memory was found to dump. Read/Write memory has not been found 
to exist on the hardware system. The 
keypad is left enabled or is in option idle 

| state. 

11 A dump disk was not found. Dump- Insert a dump disk into a valid drive and 
To-Disk requires a write enabled, power up. The keypad is enabled or is in 
operational disk on the dump disk option idle state. It is necessary to 
channel. respecify the Dump-To-Disk option. 

12 The end of the dump disk was See action for error code 11. 
reached before the dump was 
complete. 

13 A valid CMS disk label was not Power off invalid disk and insert a valid 

found on the first write enabled, dump disk in the correct drive. 
| operational disk. 
01 A disk seek error has occurred. The error may have been caused by 


either the disk or the disk drive unit. 
Reinitiate the Dump-To-Disk using 
another disk and/or alternative drives 
where available. 


A disk read error has occurred. Same action as for 01. 


A disk write error has occurred. Same action as for 01. 


ROM Dump Display Reference Table 


Tables 9-21 and 9-22 contain ROM Dump display information. 


Table 9-21. ROM Dump Display Reference Table 


Identifier| Display Bank(s) 
Disk controller primary status. 


Disk controller secondary status. 

Data offset or micro offset where the error occurred. 

The contents of the max hardware register at the time of the 
failure. 

The disk sector address where the error was detected. 


The STATUS code found in bank ‘‘E’’ may be decoded as 
shown in table 9-22. 
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Table 9-22. Bank E Display for ROM Dump 


A write operation was being performed when the 
error occurred. 

A read operation was being performed when the 
error occurred. 

A data access was in progress when the error 
occurred. 

A micro instruction was being fetched when the error 
occurred. 

An attempt was made to access non-existent memory. 


Data/micro 1 
access 


Memory limit 1 
error 

Boundary error 1 
Write parity 1 
error 

Read parity error 1 
Error state 1 


A boundary error has occurred. 
A write parity error has occurred. 


A read parity error has occurred. 

An error has occurred since the last clear or reset 
ciror status word command. 

An error has not occurred since the last initialize or 
reset error command. 

A second error has been detected before the error 
state bit was reset. Occurrence of a second error will 
freeze the processor. 

A second error has not occurred. 


Second error 


NOTE Bank E status bit 0 is the least significant bit. For example, if Bunk E contains a 
@22@, this indicates that a read parity error occurred while doing a daia access. 
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SPECIAL CONSIDERATIONS 


This subsection contains information which does not apply to one individual section such as COLD- 
START or WARMSTART but applies to B 900/CP 9500 systems in general. 


Pseudo-Pack Concepts 


ks (also called pseudo disks) is unique to the B 900/CP 9500. Pseudo-packs 
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fixed disks. 
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This concept allows multiple fixed disk drives to be handled as one large contiguous disk. 
The fixed disk media can be utilized in two different ways: 


1. It is possible for space on all the fixed units to be logically concentrated into one large available 
area. Files can then be placed on the fixed disks without the operator being concerned about 
the physical disk on which they are located. 


2. It is possible for the operator to assign files to a physical disk drive if necessary. 


Many users run several different application programs during the course of a day. Often, these pro- 
grams require the disks to be labelled with specific names. The concept of pseudo-packs allows the 
user to maintain a table of these disk names on the fixed disk. This means the user neither has to 
eclahel the dick every time he wants to run an application, nor to modify the programs to change the 
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disk name they require at the moment. 


A table of pseudo-pack names is created during COLDSTART when the fixed disk is initialized. The 
names of all fixed disks on the system at that time are placed in the table. This entry is referenced 
for system files and user files assigned to the system disk. 


As you become familiar with the computer, the convenience of adding pseudo-pack names to the table 
will be more obvious to you. 


They are added with a simple command: AP (Assign Pseudo-pack). 


The syntax of this command is explained in the Utilities and Intrinsics section. It would be most fre- 


quently used as: 
AP NEWDISK/ 


or 
AP NEWDISK/ ON DKA 
(where DKA is the name of the physical unit). 


Pseudo-packs are manipulated like any physical disk. For example, they can be relabelled using the 
RL command. 


Files are accessed by giving the disk name followed by the file name. 


Example: 
PD FIXEDA/PRMASTER 


The system pseudo-pack has one unique characteristic which is very convenient for the operator. A 
file that is placed on the system pseudo-pack (called SYSPACK) can be accessed using only the file 
name. 
Example: 

PD PRMASTER 


2032801 ean 


re ie 


Using PD SYSPACK/PRMASTER, which follows the rule, is perfectly correct and also will access the 
file PRMASTER. Omitting the disk name is merely a convenient shortcut for the operator. 


Refer to section 4 of this manual for additional information about pseudo-pack concepts. 


Data Communications 
The data communications system connects users at terminals other than the SPO to the computer. 


A detailed explanation of how this system operates is contained in the Computer Management System 
(CMS) Data Communications Subsystem Reference Manual, form 1090909. However, a brief overview 
of data communications may be helpful for the operator. 


The B 900/CP 9500 systems are designed for the efficient use of data communications lines. A basic 
system can have many terminals attached to it. 


Probably the best way to visualize this system is as terminals which are some distance from the system 
itself. 

in a school system for example, the computer processor, SPO, disk files and printer are probably lo- 
cated in one room in an administration building. However, the people who need to use the system 
are in other rooms in the administration building and also in separate buildings such as various elemen- 
tary and high school offices. 


Operators at these terminals, other than the SPO are called ‘‘remote’”’ users. The remote terminals are 
attached to the computer through a communications system. Sometimes these remote terminals are 
wired directly to the processor, but most often they are connected through telephone lines. 


When Burroughs supplies programs to operate your computer system, a package which operates these 
data communications lines is included. Each time a system is started, the operator can choose whether 
or not to start (bring up) the data communications system. 


Until the computer operator types the appropriate command into the system, none of the remote users 
can operate their terminals. 


At the end of the working day, the system operator brings down the data comm system before shutting 
off the processors and disks. This also requires a special command which is supplied by Burroughs. 


Remote users can communicate with the system once the data comm system has been started. However, 
compared to the system operator they have less authority. There are also slightly different rules govern- 
ing the way remote users can communicate with the system. 


You should be aware that remote users cannot use the computer until their system is activated, that 
they have slightly different operating rules and that there are some differences in the way they commu- 
nicate with the system. 


Enhanced Terminal SPO 

The Enhanced Termnal SPO (ETS) feature allows data comm terminals to enter SCL (System Control 
Language) commands. A terminal designated as a terminal SPO can ready a printer, assign a device, 
enter a MX, DS a program or enter any other commands which previously could only be entered from 
the local SPO. 


To allow a terminal to be a SPO, the following conditions must be true. 
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1. Using the CONFIGURER utility, the Operator Control Flag field in the SYSCONFIG file must 
be set to ALL. 


2. In the NDL, the SPOCAPABLE flag in the terminal section must be set equal to TRUE. This 
statement is not required in the NDL and will default to SPOCAPABLE = TRUE. 


_ Also in the NDL, if a station references a SPO capable terminal, the station’s SPO capability 
is controlled by the SPO=TRUE fiag in the station section. This flag defaults to false. If the 
SPO flag is set to FALSE or if the statement is not present, a REDEFINE.STATION communi- 
cate may be issued. 

The REDEFINE.STATION communicate (RS) is explained in the GEMCOS User’s Manual 
(form 1106796). Bit 4 of the TYPE field is now used to set the SPO capability of a station. 
To find out what the TYPE field of a station contains enter: 

$OL S <Isn> D 
where Isn is the logical station number. 
The TYPE field can then be reset so bit 4=1, making the station SPO capable: 

$RS <Isn>/TYPE= @nnnn@ 
where nnnn are the four hex digits defining the station type. 
The line associated with the station being redefined should be made not ready before the com- 
mand is issued and should be made ready after the command (refer to the GEMCOS User’s 
Manual form 1106796). 
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SPO capable stations can be switched between two modes. The station will come up in ‘‘application’’ 
mode. This mode corresponds to the normal operation of the station and it will behave as in previous 
releases. 


Depressing the ‘“SPECIFY” key switches the station into ‘““SCL’’ mode. On stations with two pages 
of memory, SCL mode will correspond to the second physicai page. On stations with one page of mem- 
ory both modes will map onto the same (only) physical page. 


There is a new option in CONFIGURER to allow a key other than SPECIFY to be used to switch 
from SCL mode to application mode. Any other key or combination of two to four keys may be desig- 
nated. This feature is designed for those users who have application programs which use the SPECIFY 
key. 


The key(s) designated to switch modes in ETS are defined in the SYSCONFIG field DC REMOTE 
SPO MODE CHANGE. Once the SYSCONFIG file has been changed, to designate mode change keys, 
the system must be re-warmstarted and data comm must be reloaded before the changes will take ef- 
fect. The cursor must be in the home position in order to switch modes if mode change keys ae de- 
fined. 


In SCL mode, the station will act like the local SPO. SCL commands can be sent to the MCP, and 
the responses will be returned to the station. If a program is started from an ETS station in SCL mode, 
any accept and display messages, and a copy of the beginning and end of job banners will be routed 
back to that station’s SCL page. Depressing the SPECIFY key again will return the station to applica- 
tion mode, the cursor will be returned to its last position and forms mode will be re-entered, if re- 


quired. 


The current state of the station will be indicated by status line messages displayed on the right hand 
side of the bottom line on the screen. When the station is in application mode and there are no SPO 
messages waiting to be displayed, the last eight characters of the status line will be blank. If there are 
SPO messages waiting to be displayed while in application mode, the status line will display ‘“SCL’’. 
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SCL mode is indicated by the letters ‘‘SCL’’ in reverse video (dark letters on light background). If, 
when in SCL mode, there are application messages waiting to be displayed, the status line will display 
‘‘APPL’’ in reverse video. 


In general, an ETS station will only receive those SPO messages and can only issue those SCL com- 
mands that are needed to control programs which it has started (for example, AX, DS, ST). If a MX 
is entered, the response will contain only those programs started from the SPO requesting the MX. 


The exception to this is when the station becomes the system SPO. The system SPO has the ability 
to manipulate the entire system and, for this reason, the unsolicited messages that give the state of 
the system (such as hardware error messages and device status messages) are routed only to the system 
SPO. In addition, every time a BOJ/EOJ banner is issued to any other SPO on the system, a copy 
will also be issued to the system SPO. The system SPO is permitted to issue certain restricted SCL 
commands (for example, AP, PO, PR). A list of these commands is given in table 9-23. There can 
only be one system SPO at any one time. At WARMSTART, the system SPO capability defaults to 
the local SPO, if there is one. The SCL command “CTL ON”’ requests system SPO capability, and 
“CTL OFF”’ releases that capability. (See section 4.) 


Table 9-23. SCL Commands And Issuing SPO 
| Mnemonic Function Issued By 


Assign Device System SPO. 
Add Pack System SPO. 
At Hostname Any SPO. 
Accept Originating SPO or system SPO. 
Candidate Any SPO. 
Change Any SPO. 
| Clear Originating SPO or system SPO. 
DB Direct to Backup Originating SPO or system SPO. 
DC Data Communications Any SPO. 
DP | Discontinue and dump Originating SPO or system SPO. | 
DS Discontinue Originating SPO or system SPO. 
DT Date — Time Changed by system SPO, interrogated by 
any SPO. 
EX Execute Any SPO. 
FD Forms Define Any SPO. 
GO Go Originating SPO or system SPO. 
HN Host Name Any SPO. 
IR Initiate Recall | Any SPO. 
KX Interrogate filesizes Any SPO. 
LB Continue recall Any SPO. 
LF Continue recall Any SPO. 
LG Log Go System SPO. 
LS Log Stop System SPO. 
MX Mix Any SPO. 
NW Network Any SPO. 
OL On Line Any SPO. 
PD Print Directory Any SPO. 
PG Purge Device System SPO. 
PO Power Off System SPO. 
PR Priority System SPO. 
RD Reserve Device System SPO. 
Relabel System SPO. 
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Table 9-23. SCL Commands And Issuing SPO 
(continued) 


RM Remove 


Issued By 


Any SPO. 


Ready System SPO. 
| SF | Substitute File | riginating SPO or system SPO. 
SM Multi-MCS data comm Any SPO. | 
SN Serial Number System SPO. 
SO Set PRBK Option System SPO. 
ST Stop Origination SPO or system SPO. 
SV | Save | System SPO. 


Test Option Any SPO. 
Vertical Format System SPO. 


NOTE The system SPO is a SPO that has successfully issued a “CTL ON’’ SCL command. 
An originating SPO is the SPO that started the program in question. 


Tape Concepts 
The B 900/CP 9500 systems can store information on tape as well as on disks and packs. 


When compared to disk, tape storage has some advantages and some disadvantages. The advantages 
are: 


1. Tapes tend to be a less expensive storage media than disks. 

2. Tapes can make it easier to move information from one computer system to an unrelated sys- 
tem. 

3. Tapes use less external storage space than disk. 


Disadvantages of tapes are: 


1. They are more susceptible to being corrupted by exposure to magnetic fields. 

2. They are less satisfactory than disk for long-term storage as the images tend to fade (that is, 
storage over several years which varies depending on the quality of the tape purchased). 

3. It takes longer to read information stored on tape into the computer system than it does to 
read the same information stored on disk. It is also faster to write information to disk than 
it is to write to tape. 


Tape Commands 


A separate set of commands is used to manipulate information stored on tape. The most frequently 
used are the variations of the LD command: LOAD, ADD, DUMP and UNLOAD. These are discussed 
in section 4 of this manual. 

OUTPUT DEVICE = “ device-id SYSMEM ” <peripheral type> 


Disk Pack Concepts 
Disk packs vary somewhat from disks in the method by which they are handled. 
1. A file called SYSHOSTLOAD must be present on the system and on-line during WARM- 
START or COLDSTART if the computer system is to recognize and access a disk pack device. 


SYSHOSTLOAD is usually stored on the system disk, but may be located on any device that 
is on-line. During the system startup, SYSHOSTLOAD is loaded to the disk pack controller. 
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: 
2. Turning on the disk pack controller also sends power to the disk pack drive. However, an oper- 


ator must press the READY button on the drive after a pack has been loaded. Files on that 
pack can then be accessed by the system. 


3. If the controller is powered-off or taken off-line, pack(s) cannot be accessed until the system 
has been re-started. 


Disk Pack Used To Store System Software 


It is possible to place the system software on a pack device. There may be some advantage to doing 
sO, aS more physical room will be available. 


To do so: 


1. The system must be coldstarted by loading system files to the pack using a B9OORLI disk. 
2. The B9OORL1 disk is then removed. 


The pack is now the home of the system disk. The operator must remember, when warmstarting the 
system when pack is the system disk, that some disk unit (fixed, cartridge or mini) must be on-line 
at warmstart time, 


sass Seasi tases 


This is because the system must access a bootstrap program in order to WARMSTART and this pro- 
gram is contained only on track zero of individual disks. Once the system has contact with a bootstrap 
program, it can recognize the system files located on pack. 


Tgsting Recording Surface of Disk Devices 
Non-Disk Pack Devices 
Bad sectors may cause INITIALIZE to terminate. In Unattended mode, this will cause COLDSTART 
to terminate. There are two ways this can occur for non-disk pack devices. ‘ 
1. The disk contains more than 50 bad sectors. This is indicated to the operator by the message: 
TOO MANY BAD SECTORS 
2. There is a bad sector in track zero, which is indicated to the operator by the message: 
TRACK ZERO HAS BAD SECTOR 


COLDSTART uses these messages to indicate the associated disk media is not fit for use on B 900/ 
CP 9500 systems. 


Disk Pack Devices 


The first phase of the INITIALIZE function for disk pack drives is called “INITIALIZE — VERIFY 
~ RELOCATE?”’, or IVR. IVR is performed on a cylinder by cylinder basis, with all passes being per- 
formed on one cylinder before moving on to the next. The passes performed on each cylinder are as 
shown in table 9-24. 


Table 9-24. Pack Initialization Procedure 


Description 


Initialize, sector addresses and a data pattern are written. 


Verify, sector addresses and the data patterns written in pass @00@. 


Initialize data fields and sector data are written with a new data pattern. 
Verify new data pattern written in pass @02@. 


During the actual IVR process, the pass number is displayed in Bank E of the hex display, while Banks 
G and H contain the decimal cylinder number of the cylinder being IVR’ed. The disk pack devices 
have the following number of cylinders: 

206 disk pack: 815, numbered 0000-0814 

205 disk pack: 407, numbered 0000-0406 


iVR Error and Failure Conditions 
The B 9387 DPDC status is displayed for all IVR error and failure conditions as follows: 
<controller mnemonic> STATUS: <extended result descriptor > 


The extended result descriptor is the B 9387 DPDC status. The extended result descriptor has the same 
breakdown as the extended result descriptor that is logged in maintenance logs and is 46 bytes long. 


The following error and failure conditions may occur during an IVR: 


1. If pass @00@ fails on any cylinder, then the IVR aborts with the message: 
UNABLE TO INITIALIZE CYLINDERS 


2. If a verify operation fails for any reason, an attempt is made to relocate the sector where the 
failure occurred. If the relocate fails, IVR aborts with the message: 
SECTOR XXXXX NOT RELOCATED 
CYLINDER XXX HEAD X SECTOR XX 


Sector Relocation 


Sector relocation is done only during the IVR process. The system will attempt to move (relocate) a 
sector that has been found to have an error to a spare sector on the cylinder. There can be a maximum 
of five relocates per cylinder. COLDSTART will display messages to indicate the success or failure of 
the relocation process and the sector address of the sector that was or was not successfully relocated. 


If a successful relocation does occur, COLDSTART displays: 


<Controller mnemonic> STATUS <extended result descriptor > 
CYLINDER CCCC HEAD H SECTOR SS RELOCATED F 


This indicates that the sector with the error has been moved (relocated) to a spare sector on the cylinder 
and the pass which detected the data error is performed again. 


If a sector relocation fails for any reason, then the IVR aborts and COLDSTART displays: 
<Controller mnemonic> STATUS <extended result descriptor > 
CYLINDER CCCC HEAD H SECTION SS NOT RELOCATED ON <DFM> 
TOO MANY BAD SECTORS 


NOTE 
The message TOO MANY BAD SECTORS is correct in this instance. It is 
an indication that the associated disk pack is not fit for use on B 900/ 
CP 9500 systems. 
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The formula used to convert the cylinder head sector display into a binary sector address is: 


206 DISK PACK: 445 * CYLINDER + 90 * HEAD + SECTOR = ADDRESS 
205 DISK PACK: 445 * CYLINDER + 90 * HEAD + SECTOR = ADDRESS 


The approximate length of time required to perform an IVR is as follows: 
206 disk pack media: 25 minutes per drive 
205 disk pack media: 12 minutes per drive 


Miscellaneous 


If @FFO000@ appears in banks ‘‘E’’, “‘F’’, ‘“‘G’’ and ‘‘H’’ respectively and the other banks are blank, 
then there is a parity error in disk processor memory. This is an indication of a hardware failure which 
will require technical assistance. 


Backup Operating System and Disk Processors 


Some systems are equipped with two additional switches on their control panel. These switches are la- 
belled as: OS PRC1/OS PRC2 and DKS PRC1/DSK PRCzZ. The function of these switches is to bypass 
faulty hardware in the operating system or disk processors. Normally, the system is configured so that 
the OS PRC1/OS PRC2 switch is in control of the OS processor when the switch is in its primary 
position (that is, OS PRC1) and the DSK PRC1/DSK PRC2 switch is in control of the disk processor 
when the switch is in its primary position (that is, DKS PRC1). If either the OS processor or the disk 
processor has faulty hardware, then the operator may continue operating the system by switching to 
a backup OS or disk processor by putting one or both of the switches in the secondary positions (OS 
PRCI1 and DSK PRC2). However, these switches are useful only if the system has the additional hard- 
ware required to support this function. Basically, the system must have two additional processors which 
are identical to the primary OS and disk processors. These two additional processors may function as 
additional task processors in accordance with WARMSTART defaults and SYSCONFIG parameters. 
By switching the OS PRC1/OS PRC2 and DSK PRC1/DSK PRC2 switches to their secondary posi- 
tions, the two additional task processors now become the OS and disk processors and the old OS and 
disk processors become task processors. The procedure used to set either the OS or disk backup proces- 
sors is as follows: 


1. Logically power-off the system disk using the PO command. 

2. Press either the OS PRC1/OS PRC2 switch to OS PRC2 or the DSK PRCi/DSK PRC2 switch 
to DSK PRC2. 

3. Rewarmstart the system using the WARMSTART procedure described under WARMSTART. 
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UTILITIES AND INTRINSICS 


The following commands are unique to the B 900/CP 9500. Each command is followed by its syntax, 


an explanation of the command and at least one example. 


ANALYZER (User Program Dump Analyzer) 


When a COBOL, 


a disk with a name DMFILnn (where n 


RPG, or MPLII prog 


avee pre 


vides an analysis of this file printed on the line printer. 


gram is du 
n is the mix number of the e program 


The ANALYZER utility can be initiated in any mix. The initiating syntax is shown below: 


ANALYZER inane < filename > ——4 
< packid > / 


where: <packid> is the name of the pack where the dump file resides. If none is specified, system 


pack is assumed. 


<filename> is the name of the dump file created when program was DP’ed. 


NOTE 


When a program is dumped, the dump file is automatically placed on the 
same disk as the program object code. 


The system responds with: 
<mix no>/ANALYZER DISP: PURGE DUMP FILE? 


<mix no>/ANALYZER REQUIRES DATA. USE ‘‘AX’’. 


n 3), a file is created on 
pat mped). This utility pro- 


The operator can then respond with AX <mix no> fellowed by YES or NO. (YES removes the 


original dump file.) 


The system then displays: 


<mix no>/ANALYZER EOJ 


CAUTION 


When analyzing a COBOL or RPG user program, if the object code file is 
removed or changed between the time the program is DP’ed and the time 
ANALYZER is initiated, the analysis is likely to be incomplete. 


Output Messages 

Message 
PACKID TOO LONG 
<packid > 


FILE ID TOO LONG 
< filename > 


INVALID CHARACTER 
IN FILE 
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Possible Causes 


A packid containing more 
than seven characters was 
entered. 


The file name containing 
more than twelve 
characters was entered. 


The initiating message 
contained characters other 
than alphanumerics, 
commas or spaces. 


Suggested Action 


Re-enter initiating message, using 
correct packid. 


Re-enter initiating message, using 
correct file id. 


Re-enter initiating message, using only 


legal characters. 
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oo 


(continued) 
Message Possible Causes Suggested Action 
<filename> NOT FOUND One of the following: If file is not on disk, install disk 
OR IN USE 1. <packid> was of valid containing dump file. Otherwise. re- 


length and contained valid enter initiating message. 
characters, but identified 

wrong pack. 

2. <fileid> was of valid 

length and content, but 

dump file is not on disk. 


***INTERP NOT Dump file is from Cease trying to analyze dump file. 
SUPPORTED*** program not handled by 

COBOL or MPLII 

interpreters. 
***NO SPECIFICATION Error in initiating message Re-enter initiating message. 
GIVEN*** not covered by preceding 

messages. 
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AP (Assign Pseudo-Pack)* 
*Pseudo-pack and pseudo-disk are interchangeable terms in this context. 


The AP intrinsic is used to create a pseudo-pack on fixed disk. For more details on pseudo-packs refer 
to Special Considerations. 


The syntax for this command is: 


AP ——————._ < pseudo-packid > / a 


a < fixed disk name > ke 
L— on 


NOTE 
The slash following the pseudo-packid is required. 


The naming format of a pseudo-pack is the same as it is for any other disk name. The name may 
be up to seven characters long and must begin with a letter. 


When a peripheral is specified as follows: 


AP PSEUDOI/ ON DFA 
the information written to that pseudo-pack goes only to the fixed disk specified (DFA), not to any 
other part of a fixed disk unit. 


However, if no peripheral is specified as follows: 


AP 
the information written to that pseudo-pack can go to any section of any fixed disk where there is 
available space. 


Consequently, creating an unrestricted pseudo-pack can resolve a NO USER DISK condition which oc- 
curs on a single physical unit, since this allows the operator to spread a file over multiple disk units. 


Note that ALL fixed disks must be physically on and ready for the command to work. 


The name of the newly-created pseudo-pack is entered into the Pseudo-Pack Identifier Table (PPIT) 
which is a list of all pseudo-packs declared on the system. 


Examples: 


AP PSEUDOI/ 
— adds unrestricted pseudo-pack ‘‘PSEUDO1”’ to PPIT. 
Therefore you can access all of the fixed disk using PSEUDO1. 


AP PSEUDO2/ ON DFA 
— adds pseudo-pack ‘‘PSEUDO2”’ to PPIT and restricts it to fixed disk A. 
Therefore, you can access fixed disk A using PSEUDO2. 


Once a pseudo-pack has been created, it cannot be removed unless the fixed disk is initialized. How- 
ever, the pseudo-pack can be relabelled. 
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Output Messages 


Message 


PSEUDO-PACK <packid> 
ADDED TO SYSTEM 


AP <packid>/INVALID 
- DISK NAME ; 
INCORRECTLY FORMED 


AP <packid> IGNORED 
— CANNOT ADD ANY 
MORE PSEUDO-PACKS 
TO SYSTEM AN 
EXISTING PSEUDO-PACK 
MUST BE USED 


AP IGNORED — PACKID 
IS ALREADY ONLINE 


AP <packid> IGNORED 
— ALL DISKS 
BELONGING TO FIXED 
DISK ASSEMBLAGE 
MUST BE ONLINE 
BEFORE COMMAND 
ISSUED. ENSURE DISKS 
ARE POWERED ON. 


AP <packid>/INVALID 
- DEVICE TYPE NOT 
ALLOWED WITH THIS 
COMMAND 


AP <packid>/ON < fixed 
disk name> INVALID 
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Possible Causes 


The command was completed 
successfully. 


The pack-id specified is not 
legal. 


The PPIT is full. 


A duplicate pack condition 
has been detected. 


The peripheral specified is not 
ready. 


The peripheral specified is not 
a fixed disk. 


The fixed disk specified is not 
on the system. 


Suggested Action 
None — normal operation. - 


Re-initiate with a valid pack-id. 


Use RL intrinsic to relabel an 
existing pseudo-pack that is no 
longer required. 


Re-initiate with a different pack- 
id. 

RY the specified device and re- 
initiate. 


Re-initiate specifying a valid 
peripheral. 


AT (At Host) 


This is only used for BNA. See the B 900/CP 9500 Burroughs Network Architecture Operation and 
Installation Guide (form 1163102). The AT intrinsic allows the user to enter a request via any BNA 
network terminal and specify which machine (HOST) is to handle the request. 


The syntax for this command is: 


AT < hostname > 


< request > — 

where <hostname> is a maximum of 17 characters long. 

Valid characters include upper and lower case A-Z, digits 0-9, the hyphen () and the underline ( ). 
The special characters (comma and underline) may not be the first character in the hostname, nor may 


two or more appear consecutively. 


Output Messages 


Message Possible Causes Suggested Action 
“AT”? IGNORED — BNA Master MCS Program Request rejected. 
SYSTEM IS NOT IN (BNAMASTER) is not 
NETWORK MODE currently in the mix and 
logged on as a programmatic 
SPO. 
“AT”? IGNORED — BNA Master’s SPO queue is Request rejected. 


BNAMASTER PROGRAM full. 
IS TEMPORARILY 
UNABLE TO ACCEPT 


COMMANDS 

“AT” IGNORED — Specified hostname is Request rejected. 
SYNTAX OF HOSTNAME incorrectly formed. 

IS INVALID 


The programmatic SPO header will have the input flag set and the text length, SPO id, SPO tag and 
SPO size fields primed with the appropriate contents. The system SPO flag will be set if this command 
came from the system SPO. 
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BINARY.COPY (Duplicate Disk Media) 


The BINARY.COPY utility allows rapid duplication of disks of the same size and type under MCP 
control. However, both disks must be CMS disks. 


Before executing BINARY.COPY, the operator must reserve the disk drives on which the BINARY- 
-COPY is being performed by the RD command. When the utility begins execution, the operator will 
be requested to assign the required disk drives (using the AD command) which were previously re- 
served. (See section 3 for an explanation of RD and AD.) 


As a precaution, the operator should also write-disable the disk to be copied. However, since the sys- 
tem does not recognize a write-disabled disk, only a BINARY.COPY can be done. To do anything 
else, the disk must be write-enabled. 
CAUTION 
The entire source disk is copied to the target disk. Any files previously on 
the target disk are destroyed. 


The following table illustrates the procedure for executing BINARY.COPY. 


Operator Enters System Messages 
RD <device mnemonic> <device mnemonic> <packid>/RESERVED 
RD <device mnemonic> <device mnemonic> <packid>/RESERVED Note: the write- 
disabled disk does not list its packid. 
BINARY.COPY ENTER TARGET PACKID <mix no>/BINARY.COPY 


REQUIRES DATA USE “‘AX’”’ 


AX<mix no> <target 
packid > 
THIS PACKID WILL BE PLACED IN THE LABEL OF THE TARGET DISK AFTER 
THE COPY IS COMPLETED. THE PACKID ENTERED SHOULD NOT BE THE SAME 
PACKID AS THE SOURCE DISK. 
<mix no>/BINARY.COPY WAITING SOURCE/SYSMEM 
<device mnemonic> DEVICE ASSIGNMENT REQUIRED 
AD<mix no> < device <mix no>/BINARY.COPY WAITING TARGET/SYSMEM 


mnemonic> (source) <device mnemonic > 
DEVICE ASSIGNMENT REQUIRED 


AD<mix no> <device 
mnemonic> (target) 


All sectors are copied from the source disk to the target disk. If errors are encountered on the source 
disk, the affected sectors will be copied as binary zeroes and the operator will be informed. The utility 
will display these messages both on the SPO and on a line printer report. 


After the copy is complete, the target disk is read to ensure no parity errors exist on it. This message 
is also printed on the SPO and on the line printer. 
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Sample Printout: 


OE AS os ois sis fs 2 ee ok oss ois 2 oe oe fe 2 OO OR OK os oe oe soe OK 2K ok OK KO OK 


BINARY COPY FROM DKD TO DKC 


CHECKING TARGET DISK FOR INPUT ERRORS 


DKD TO DKC COPIED AS PPD3 


The drives that were reserved must now be made ‘‘ready’”’ using RY <device mnemonic>. 


Example: 
To copy disk GEORGE on DKA to HARRY on DKB: 

Enter: 
RD DKA 
RD DKB 
BINARY.COPY 

The system will then ask for the name of the target disk. Enter: 
AX <mix no> HARRY 

The system will then ask for the drive the source disk is on. Enter: 
AD <mix no> DKA 

The system will then ask for the drive the target disk is on. Enter: 
AD <mix no> DKB 

The binary copy utility wili now begin executing. When it is finished, enter: 
RY DKA 
RY DKB 


Special Considerations 


For a disk pack system configured as follows, special procedures are required: 
Loader disk: two 3/6 mini drives, or, 
one 1 MB mini drive 
System disk: two 205/206 disk pack drives 


With this configuration, BINARY.COPY is unable to execute from the system disk if the disk packs 
are to be duplicated. Thus, to use BINARY.COPY, the MCP must be run from the loader disk drive. 
This requires the following files to be present on the mini disk: 


SYSBOOTSTRAP 
SYSDSCP 
SYSHOSTLOAD 
SYSWARMSTART 
SYSMCP1 
SYSMCP2 

SYSICP 

SYSMPLII 
SYSLANGUAGE 
SYSTRANSLATE 
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SYSCONFIG 
BINARY.COPY 
SYS-SUPERUTL 


The mini disk should be B 900 initialized with only 20 files declared. The TL utility and log files must 


not be on the disk. 


The following information must be specified in the SYSCONFIG file to execute BINARY.COPY from 


a mini disk. 
BUFFERMEM 128 
DC BUFFER 0 
1 MPLIIT TASK PROCESSOR 128 
MAXMIX 4 


Output Messages 


Message 


ONE OR MORE NON- 
BLANK CHARACTERS 
ARE EXPECTED 


INVALID CHARACTER 
IN DISK-NAME 

<packid > 

< pointer > 


SOURCE AND TARGET 
DISKS ARE NOT THE 
SAME TYPE 


BINARY.COPY FROM 
<source disk mnemonic> 
TO <target disk 
mnemonic > 


TRACK ZERO ON <disk 
mnemonic> HAS A BAD 
SECTOR 


OUTPUT ERROR ON 
TARGET DISK — TRY 
ANOTHER DISK 


TRANSIENT INPUT 
ERROR IN <start 
address> TO <end 
address > 


INPUT ERRORS 
OCCURRED ON THESE 
SECTORS 
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Possible Causes 


A pack-id containing 
imbedded blanks was entered. 


A pack-id containing a 
character other than A-Z, 0-9 
or — was entered. <pointer> 
is an asterisk appearing 
beneath the first invalid 
character. 


Both disks must be the same 
type of media. 


Utility is in copy phase. 


An error exists on track zero 
of specified disk. 


A fatal error was encountered 
on the target disk. 


When reading a block of 32 
sectors, an error occurred; but 
when trying to determine 
which of the 32 sectors has 
the error, the error did not 
occur. 


This message heads a list of 1 
to 32 decimal sector addresses 
which had errors and were 


Suggested Action 
Check input and re-enter. 


Check input and re-enter. 


Use the CMS copy utility to copy 
unlike disk types. 


None, normal operation. 


If target disk is specified, try 
another disk. If source disk is 
specified, use backup disk. 


Try another disk. 


Run CHECK.DISK utility against 
source disk, then use XD utility 
to delete the bad sectors. 


Run KA utility against target 
disk. Check list of sectors in 
error against KA. If sectors are 


Message 


<number> SOURCE DISK 
INPUT ERRORS 


BNICAIINTEREN 
BINCUUINE ERED 


<source/target > DISK IS 
NOT A CMS DISK 


CHECKING TARGET 
DISK FOR INPUT 
ERRORS 


READ CHECK ON 
TARGET DISK 
COMPLETE 


<source disk mnemonic > 
TO <target disk 
mnemonic> COPIED AS 
<target pack-id> 
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(continued) 
Possible Causes 
copied as binary zeroes. This 
message appears on line 
printer report only. 


The <number> is the total 
number of sector addresses 
VWetad ac in rrar in tha 
siStea aS in error in tne 


preceding message. 
The indicated disk does not 


contain a standard CMS label. 
Utility is verifying target disk. 


Indicates verification phase is 
complete. 


Indicates copy phase is 
complete. 


Suggested Action 
within file areas, remove files 
from target disk and recopy from 
backup disk using COPY utility. 


None. 


Replace indicated disk with a 
CMS disk. 


None, normal operation. 


None, normal operation. 


None, normal operation. 
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CA (Candidate) 


This is only used for BNA. Refer to the B 900/CP 9500 Burroughs Network Architecture Operation 
and Installation Guide (form 1163102). 


The CA intrinsic allows the user to inquire about the candidate entries on the port candidates for match 
list. 


The syntax for this command is: 


ee 
< portname > 


where <portname> is a maximum of 17 characters long. Valid characters are upper and lower case 
A-Z, digits 0-9, the hyphen (—) and the underline ( ). 


Output Messages 


Message Possible Causes Suggested Action 
“CA”? IGNORED — Port Candidate for Match list Request rejected. 
CANDIDATE LIST is empty. 
EMPTY 
<faulty SCL input> Specified port name is not Request rejected. 


IGNORED —- SPECIFIED found in the Port Candidates 
PORT NOT FOUND IN for Match List 
LIST 


END CA Entries found on list; end of None. 
candidate descriptions. 


If entries are found on the list, the response will consist of a report on each candidate. 
The local port response is: 


CANDIDATE <port name> [<may-subport-index >] 

MY HOST = <my-host-name>, YOUR HOST = <your-host-name>, 

MY NAME = <my-name>, MY USERCODE = <my-usercode>, 

YOUR NAME = <your-name>, YOUR USERCODE = <your-usercode>, 
PROGRAM = <my-codefile-name>, ON <my-family-name>, 

SECURITY = <security-type>, MATCHING STATUS = <matching status> 


The remote port response is: 


CANDIDATE <port name> 

MY HOST = <my-host-name>, MY NAME = <my-name>, 

MY USERCODE = <my-usercode>, YOUR NAME = <your-name>, 
PROGRAM = <my-codefile-name>, ON <my-family-name>, 
MATCHING STATUS = <matching status>) 
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CONFIGURER (System Configuration Utility) 


When the system is warmstarted, its configuration is determined from information found in the SYS- 
CONFIG file. 


The CONFIGURER utility allows the user to make a new SYSCONFIG file, modify the existing SYS- 
CONFIG file, print the existing SYSCONFiG file, or display the existing file on the SPO. The SYS- 
CONFIG file is used: 

1. By the B 900/CP 9500 WARMSTART code to determine the system’s logical configuration as 

desired by the user. 

2. To store parameters that must be maintained across WARMSTARTs. 


any disk. 


CONFIGURER displays messages to the user and accepts responses via the system SPO using the CMS 
““AX”’ (accept) intrinsic. These responses determine its actions. 


NOTE 
The SYSCONFIG file is instrumental in determining how the system re- 
sources are allocated for optimal use and performance. Therefore, it is 
strongly recommended that only those persons familiar with the particular 
system’s physical characteristics be allowed to alter the SYSCONFIG file. A 
Burroughs field engineer can assist in identifying the system’s physical charac- 
teristics. 


Table 9-25 summarizes the structure of SYSCONFIG. 
Table 9-25. Structure of SYSCONFIG File 


Task processor assignments. 

Data comm processor assignments. 

BNA processor assignment. 

SNA Processor Assignment 

B974 Processor Assignment 

Buffer memory allocation. 

Mix limit. 

System operator control flag. 

System message logging on or Off. 

Filled log file handling scheme cyclic or non-cyclic. 
Size of each primary log file. 

Size of each secondary system message log file. 
Size of each secondary maintenance log file. 
Disk-name for secondary log files. 

Size of each printer backup file. 

Data comm NDL file name. 

Data comm reconfiguration file-name. 

BNA host name. 

System message dictionary file-name. 

Line printer translation table name. 

System start-up zip text. 

System power off message. 

DC REMOTE SPO MODE CHANGE 


— system independent. D -— system dependent 
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PRINT 


Selecting CONFIGURER’s print option causes the utility to find a SYSCONFIG file that has the 
specified (or default) file name and list its contents on the line printer. 


An example of PRINT option’s output is shown in figure 9-5. This example shows the default values 
of the SYSCONFIG file as they are provided with the 3.05 B 900/CP 9500 CMS software release. 


Initiation 
The initiating syntax for CONFIGURER is as follows: 


Operator Enters System Messages 


CONFIGURER <mix-no >/CONFIGURER COMMENCING 
<mix-no>/CONFIGURER DISP: 
<mix-no>/CONFIGURER DISP: DO YOU WANT TO 
MAKE A NEW SYSCOMFIG FILE, 
PRINT AN EXISTING SYSCONFIG FILE, 
DISPLAY AN EXISTNG SYSCONFIG FILE, 
MODIFY AN EXISTING SYSCONFIG FILE, OR 
END THE CONFIGURER PROGRAM? 
ENTER MAKE, PRINT, DISPLAY, MODIFY, OR END. 
<mix-no >/CONFIGURER REQUIRES DATA. USE ‘AX’’. 


AX <mix-no> <option> 


Entering AX <mix-no> END sends CONFIGURER to end-of-job. The following message informs 
the user when CONFIGURER has terminated. 


<mix-no>/CONFIGURER TERMINATED 


When selecting PRINT, DISPLAY, MAKE, or MODIFY, CONFIGURER will ask for a filename. If 
no filename is specified, the default is ‘“SYSCONFIG’’. A pack-id may also be specified, or it will 
default to the system disk pack-id (seven ASCII zeros or SYSPACK). Therefore, if null input is entered 
for these two fields, the default is ‘‘0000000/SYSPACK’”’. 
NOTE 

The task processor and data comm processors are assigned by WARM- 

START as follows: WARMSTART identifies the OS and disk processors, 

and divides the remainder into those that are I/O capable and those that are 

not. The I/O capable processors are designated as data comm processors, and 

the non-I/O capable as task processors. 


The data comm processor with the highest physical bus address is assigned 
logical DCP number 0 (zero). The next highest bus address is assigned DCP 


number 1 and so on. 


WARMSTART also determines how much physical memory is attached to 
each task processor. All interpreters are assigned to task processors that have 
greater than 128 kB of memory. Otherwise COBOL and MPLII are assigned 
alternately. Data comm buffer space is allocated at half the amount of total 


buffer memory. 


pO 


B 900 CONFIGURER LISTING OF 0000000/SYSCONFIG 
AT 13:43:56 ON 10/20/82 


NUMBER OF TASK PROCESSORS = 5 
INTERPRETER(S) IN TP 1 = MPLII/COBOL 
MEMORY ON TP 1 = 256 K BYTES 
INTERPRETER(S) IN TP 2 = MPLII/COBOL 
MEMORY ON TP 2 = 256 K BYTES 
INTERPRETER(S) IN TP3 = MPLII/COBOL 
MEMORY ON TP3 = 256 K BYTES 
INTERPRETER(S) IN TP 4 = BASIC/MPLII 
MEMORY ON TP 4 = 256 K BYTES 
INTERPRETER(S) IN TP5 = MPLII/COBOL 
MEMORY ON TPS = 128 K BYTES 


— 


NUMBER OF DATA COMM PROCESSORS = 
BUS ADDRESS OF LOGICAL DCP 0 


i 
ao 


NUMBER OF BNA PROCESSORS = 0 
NUMBER OF SNA PROCESSORS = 0 
NUMBER OF B974 PROCESSORS = 0 
TOTAL SIZE OF BUFFER MEMORY = 80 K BYTES 


SIZE OF DC BUFFER SPACE = 40 K BYTES 
MIX LIMIT = 11 
SYSTEM OPERATOR CONTROL FLAG = LOCAL ODT 
SYSTEM MESSAGE LOGGING = ON 
FILLED LOG FILE HANDLING SCHEME = CYCLIC 
EACH PRIMARY LOG FILE = 32 SECTORS 
EACH SECONDARY SYSTEM MESSAGE LOG FILE = 32 SECTORS 
EACH SECONDARY MAINTENANCE LOG FILE = 32 SECTORS 
DISK NAME FOR SECONDARY LOG FILES = 0000000 
SIZE OF EACH PRINTER BACKUP FILE = 9999 RECORDS 
DATA COMM NDL FILE NAME = 0000000/NDLSYS 
DATA COMM RECONFIGURATION FILE NAME = SYSRECON 
BNA HOST NAME = ‘ ’ (UNDEFINED) 


SYSTEM MESSAGE DICTIONARY FILE NAME 


SYSLANGUAGE 

LINE PRINTER TRANSLATION TABLE NAME = NO TRANSLATION 
SYSTEM START-UP ZIP TEXT = <EMPTY > 

SYSTEM POWER OFF MESSAGE = SYSTEM HAS BEEN POWERED DOWN 
DC REMOTE SPO MODE CHANGE = @1B22FFFF®@ 


Figure 9-5. Sample SYSCONFIG File 
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sc a a a ee 
MAKE 


Selecting the CONFIGURER utility ““MAKE’’ mode causes the following to occur: 


1. A workfile is created to serve as a temporary container for the SYSCONFIG file. 

2. The CONFIGURER program gives the operator the option of allowing the program to auto- 
matically build SYSCONFIG using the standard (default) values, displaying the standard values 
ae are used in the AUTO mode on the SPO, or manually building a customized SYSCONFIG 

ile. 

3. After all fields have been generated, the workfile is closed with remove. It is given the filename 
which the user specified, or allowed to default to SYSCONFIG. 

4. The user is then asked to select another option of CONFIGURER to proceed or end the pro- 
gram. 


MODIFY 
Selecting the MODIFY option causes the following to occur: 


i. Configurer finds the SYSCONFIG file having the specified (or default) filename. 

2. A workfile is opened to serve as a temporary SYSCONFIG container, and the contents of the 
current SYSCONFIG file are copied into the workfile. 

3. The user is presented with a numbered list of all the fields in a SYSCONFIG file. The fields 
to be modified are selected and entered by a list of corresponding numbers. 

4. When MODIFY mode is finished, the workfile is closed with remove, and given the specified 
(or default) file name. 


The following paragraphs describe the fields of SYSCONFIG and the values which may be assigned 
to them while in the MAKE or MODIFY mode. In general, null input is valid and will cause a default 
value to be assigned to the field in question. Default values are given in parentheses (default = _ ). 


The SYSCONFIG file begins with a system dependent area that contains information needed to 
WARMSTART the physical system. This section specifies the processors and buffer memory. 


Number of Task Processors 


Enter a number from 0 to 6. Depending on the system there can be up to six task processors on the 
system. If there is no requirement for the DCP (data comm processor) on the system, the DCP can 
be used as a task processor. If the user enters 0, the system will assign the task processors at WARM- 
START. 


Interpreter Assignments 


For each task processor enter MPLII, COBOL, BASIC, NW OPTION. The NW (network interface) 
option loads the SYSBLAISE interpreter for running SNA applications. 


MPLII must be assigned to at least one task processor or the utility will loop back and request the 


task processor assignments again. For each task processor, a decimal number between 67 and 1024 
must be entered, representing the number of K bytes of memory the processor will have. 
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NOTE 


The upper limit for the memory in a task processor corresponds to 16 pages 
of local memory. This reflects the address capacity of the hardware registers. 
Task processors currently support a practical limit of 512 KB for this 
parameter. The BNA TP must be configured with 512 KB; any TP currently 
supporting more than one interpreter must have a minimum of 128 KB. 


Number of Data Comm Processors 


eval fas 


Enter a number from 0 to 4 to specify the number of processors to be reserved for data 

the user selects MODIFY and changes the number of data comm processors, the system will display 
the amount of total buffer and data comm buffer memory allocated and ask the user if these values 
must also be changed. 


If a data comm processor is assigned, the user must also specify the bus address and the logical DCP 
number for the processor. The physical bus address relates to the hardware configuration of the system, 
and requires an integer input from 1 to 15. The logical DCP number is a value that is defined as part 
of the NDL process. This field requires input of 0 to 7. 


Number of BNA Processors 


After the information for the data comm processors has been collected, the user has the option of 
assigning a BNA processor to the system. (Refer to the B 900/CP 9500 Burroughs Network Architec- 
ture Operation and Installation Guide, form 1163102). The standard response to the prompt is ‘‘NO’’. 
If the user does assign a BNA processor to the system, the allowable format for a host name is ex- 
plained in the prompt. (Default = NO.) See BNA HOSTNAME field later in this section. The system 
will allocate 512 KB of memory to a BNA processor. 


Number Of SNA Processors 


The user has the option of assigning a processor as an SNA processor for the purpose of running SNA 
interface environmental software, in particular the PU.TS IBM interface program. (Refer to the B 930/ 
CP 9580 SNA PU.TS Operator’s Guide, form number 1173127.) The system wiil allocate 512 KB of 
memory to this processor. 


Number Of B 974 Processors 


The ability exists to dedicate a processor as a B 974 processor, in preparation for an application pack- 
age not yet released at this PCN. The user may assign from 64 KB to 1024 KB of memory to a B 974 
processor. 


Buffer Memory 


The size specified in this field represents the amount of memory store to be allocated by WARM- 
START for system buffer memory use. CONFIGURER requests the total amount required, where 1 
K8 = 1024 bytes. The portion of buffer space needed for data comm is taken out of this total. The 
amount entered for data comm buffer space, prompted after total buffer memory is allocated, must 
be at least 10 KS less than the total. If CONFIGURER detects this is not true, an error message is 
displayed. A minimum of 2 KB is required for data comm buffers; the maximum value is 1014 KB. 
As previously mentioned, the default value for DC buffer space is one half of the amount declared 
for total buffer memory. See table 9-26, Default Values. The user must enter an integer 10 to 1024, 
or 12 to 1024 if data comm will be run, representing the total kilobytes of buffer memory. 


Mix Limit 


The maximum mix limit supported is 31 jobs. The user must enter a decimal integer between 1 and 
31. No more than this number of jobs will be run in the mix at one time for system execution. (Default 
= 11). 
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Table 9-26. Default Values 


Available OS 
Processor _ Total Buffers 
Memory 


DC Buffers 


4 pages or more 80 kB 40 kB 
3 pages 64 kB 32 kB 
2 pages 32 kB 16 kB 


Control Flag 


The control flag field indicates whether or not the system is to allow a message control system (MCS) 
program to act as the SPO. (This allows a data comm device to be a remote SPO). (Default = local 
SPO.) 


Logging 


This field is a flag designating whether system message logging is on or off. The user can enter ON 
or OFF depending on whether he wishes all SPO messages to be recorded in log files. (Default = ON.) 


Log File Handling Scheme 


This field is a flag designating whether filled log files are handled in a cyclic or non-cyclic fashion. 
Cyclic refers to the type of logging where messages could get overwritten when all the primary log files 
are full. Operator intervention is required to print or transfer the full set of primary log files to prevent 
losing entries. Non-cyclic refers to the type of logging where more than one holding file is created when 
all the primary log files are full. No operator intervention is necessary as no entries will be lost. See 
section 4 for more information on logging. The user must enter CYCLIC or NON-CYCLIC. (Default 
= CYCLIC.) 


Primary Log File 


The primary log files are created and maintained by SYS-SUPERUTL. They are labelled SYS-LOG- 
01 through SYS-LOG-04. The user must enter a filesize in sectors (from 32 to 16,383) for the primary 
log files. (Default = 32.) 


Secondary Log File 


The secondary log files, created and maintained by TL, include SYS-LOG-HOLD, SYS-MLGJJJNN 
and SYS-HLDJJINN. “‘JJJ’’ is the Julian date and ‘‘NN’’ is the number of the log file. SYS-LOG- 
HOLD is used when CYCLIC logging is being performed; SYS-HLDJJJNN is used when CYCLC log- 
ging is running. The user must enter the filesize in sectors (from 32 to 262, 140 sectors). (Default = 
32.) 


Maintenance Log File 


The data in this secondary log file is a record of all maintenance entries, stored in a non-cyclic fashion. 
That is, a new maintenance file is created when the current one is full. Maintenance entries are not 
lost or overwritten. SYS-MLGJJJNN is used by both CYCLIC and NON-CYCLIC logging. The user 
must enter the files in sectors, from 32 to 262,140. (Default = 32.) 


Disk Name For Secondary Log Files 


The user is prompted to enter the pack-id where the secondary log files (including the maintenance 
log files) will reside. 0000000 denotes the system disk. (Default = 0000000.) 
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Printer Backup File 


The user should enter an integer between 1 and 999,999 to indicate the number of records each printer 
backup file will generate. (Default = 9999.) 


NDL File Name 


This field contains the file name of the NDLSYS file that is to be used in setting up the CMS data 
comm subsystem. The required input is ‘“‘NDLSYS’’ or null input to allow the default value 
“NDLSYS”’ to be assigned, as this field is currently not allowed to vary. (Default = 0000000/ 


NDLSYS.) 


Reconfiguration Filename 


This field specifies the name of the file on the system pack to be used by the MCS as a container 
for information regarding the data comm subsystem mapping. Currently, this field may not vary; the 
user must enter SYSRECON, or allow the default value to be used. (Default = SYSRECON.) 


BNA Hostname 


If the user specified a BNA processor to be configured on the system, this field must contain a valid 
BNA hostname. The hostname may be a maximum length of 17 characters consisting of letters, digits, 
underline and hyphen. The name may not have two separators (underlines or hyphens) next to each 
other. If the user did not specify adding a BNA processor to the configuration, no prompt for host- 


name is presented. (Default = null input.) 


System Message Dictionary Filename 


This field holds the name of the file used to generate system messages to the SPO. The user must 
enter a valid CMS filename specifying the dictionary file to be used. (Default = SYSLANGUAGE.) 


Line Printer Translation Table 


This field names the translation table to be used for the printer. The user may enter NO TRANSLA- 
TION, or from 1 to 20 alphanumeric characters for the translation table name. (Default = NO 
TRANSLATION.) See table 9-27 for translation table names. 


Table 9-27. Translation Table Names 


VERSION 1 VERSION 5 


Australia Austria 
Canada Czechoslovakia 
Korea Germany 

New Zealand Switzerland 


USA 


VERSION 6 
Brazil 
Portugal 


VERSION 1A 
This version is to be used with IBM 
compatible RJE 

application packages: 360/20, 3780, SNA-RJE 


Portuguese West Africa 
Portuguese East Africa 


VERSION 2 
Bahamas 
Barbados Cont’d 


VERSION 7 
Argentina Cont’d 
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Table 9-27. Translation Table Names 
(continued) 


Chile 
Columbia 


Bermuda 
Central Africa 


Ceylon Costa Rica 

East Africa Dominican Republic 

Fiji Ecuador 

Ghana Honduras 

Guyana Mexico 

Holland Nicaragua 

Hong Kong Panama 

Indonesia Peru 

Jamaica Phillipines 

Kenya Puerto Rico 

Malaysia Spain 

Malta Uruguay 

Netherlands Venezuela 

Nigeria USA 
VERSION 8/8A 

Singapore Denmark 

South Africa Norway 

Taiwan 

Thailand VERSION 9 

Trinidad Yugoslavia (Croatian) 

United Kingdom 

USA 

Zimbabwe VERSION 10 
Finland 

VERSION 3 

Algeria Sweden | 

Belgium 

France VERSION 14A 


French Guiana 
French West Indies 
Malagasy Republic 


Turkey 


VERSION 16A 


Morocco Iceland 
Tunisia 
West Africa VERSION 24 


Zaire Katakana 


VERSION 4 
Italy 


These tables are to be used for the B 9249-2/3/4 line printer. 


The B 9249-30/50 requires translation only for the following countries: 
Denmark, Norway — specify Version 8A. 

Turkey — specify Version 14A. 

Iceland — specify Version 16A. 


The B 924-E printer requires ‘‘Version 24 128 char’’ to be specified. 
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System Start Up Zip Text 


This field contains the program that the CMS SYS-SUPERUTL is to zip as soon as it starts executing 
(at WARMSTART). The user may enter from 0 to 255 valid ASCII alphanumeric characters that con- 
stitute a valid program name. Null input indicates no start up zip text is to be used. (Default = 
<empty >.) 


Power Off Message 


This message is displayed on the SPO when the system disk is powered off. It is therefore the last 
message displayed on operator shutdown of the system. Enter from 0 to 80 valid ASCII alphanumeric 
characters. (Default = SYSTEM HAS BEEN POWERED DOWN.) 


DC Remote SPO Mode Change 


This field specifies which key (or keys) must be depressed on this terminal to switch from application 
mode to SPO mode of the terminal. Refer to the paragraph on ETS. The mode change keys, or flip 
string must have a length of 1-4 keys, and must be entered in ASCII or hex. ASCII input must be 
enclosed by quotes and hex input must be enclosed by @. The word ‘‘SPCFY”’ is also valid input, 
as is null input. Both of these indicate the Specify key is to be used for the ETS flip string. (Default 
= @1B22FFFF@ which defines the Specify key.) 


DISPLAY 
Selecting CONFIGURER’S display option will list on the SPO the contents of the SYSCONFIG 
file with the filename or diskname/filename the user specifies. The format is the same as is shown 


in the PRINT option example. 


2032801 9-85 


nt te es 
DUMPFILE.UTL (System Dump File Segmenter) 


DUMPFILE.UTL allows a large dumpfile to be divided into a number of smaller files. This is espe- 
cially useful when a dumpfile is too large to fit on one disk. The most convenient method of sending 
a dumpfile to a Burroughs support group is on a mini disk. If the dumpfile is too large to fit on one 
mini disk, DUMPFILE.UTL can be used to divide the dumpfile into parts. The parts can then be sent 
on several mini disks. 


DUMPFILE.UTL will also reconstruct the file in its original form. The number of files created by 
DUMPFILE.UTL depends on the size of the original dumpfile. 


The syntax for executing DUMPFILE.UTL is: 
DUMPFILE.UTL ——_—_—__—————__| 


DUMPFILE.UTL will prompt the user to enter one of two options by displaying the following mes- 
sages: 
<mix no>/DUMPFILE.UTL BOJ PR IS A 
<mix n0>/DUMPFILE.UTL DiSP: ENTER P TO PARTITION A FILE INTO PARTS 
<mix no>/DUMPFILE.UTL DISP: ENTER R TO RECONSTRUCT A FILE FROM ITS 
PARTS 
<mix no>/DUMPFILE.UTL REQUIRES DATA USE ‘‘Ax” 


The user must respond by entering a ‘‘P”’ or an ‘“‘R”’ using the AX intrinsic. For example, AX <mix 
no> P 


File Partitioning 


If the user selects file partition, then DUMPFILE.UTL prompts the user to enter the disk-id and file- 
id of the system dumpfile to be partitioned and the disk-id of the disk which will hold the file partitions 
by displaying the following messages: 

<mix no>/DUMPFILE.UTL DISP: ENTER DISK-ID OF SYSTEM DUMPFILE 

<mix no>/DUMPFILE.UTL REQUIRES DATA USE “AX” 

<mix no>/DUMPFILE.UTL DISP: ENTER FILE-ID OF SYSTEM DUMPFILE 

<mix no>/DUMPFILE.UTL REQUIRES DATA USE “AX” 

<mix no>/DUMPFILE.UTL DISP: ENTER DISK-ID OF OUTPUT DISK 

<mix no>/DUMPFILE.UTL REQUIRES DATA USE “Ax” 


NOTE 
The first DISK-ID refers to the disk where the dumpfile is originally located. 
The user must respond with valid disk-ids and file-ids when requested. 
DUMPFILE.UTL will display a message for each partition created and a 
completion message when partitioning is complete. See following example. 


<mix no>/DUMPFILE.UTL DISP:<OUTPUT DISK-ID>/ DMFILEPART00 CREATED 
<mix no>/DUMPFILE.UTL DISP: <OUTPUT DISK-ID>/DMFILEPART01 CREATED 
<mix no>/DUMPFILE.UTL DISP: <OUTPUT DISK-ID>/DMFILEPART02 CREATED 
<mix no>/DUMPFILE.UTL DISP: <OUTPUT DISK-ID>/DMFILEPART03 CREATED 
<mix no>/DUMPFILE.UTL DISP: FILE PARTITIONING COMPLETE 

<mix no>/DUMPFILE.UTL DISP: PROGRAM TERMINATING 

<mix no>/DUMPFILE.UTL EOJ 


eee ””—0_—_—" 


When the space on the output disk is filled, the user will be prompted to power off that disk and 


insert a new one. 


File Reconstruction 


If the user selects file reconstruction, then DUMPFILE.UTL will prompt the user to enter the disk- 
id and file-id for the recreation of a system dumpfile followed by the disk-id of the disk that contains 
the system dumpfile parts. For example: 


a 
Ly OYUN 


<mix no>/DUMPFILE.UTL DISP: ENTER DISK-ID OF DESTINATION 
<mix no>/DUMPFILE.UTL REQUIRES DATA USE ‘‘AX”’ 

<mix no>/DUMPFILE.UTL DISP: ENTER FILE-ID OF DESTINATION 
<mix no>/DUMPFILE.UTL REQUIRES DATA USE “AX” 

<mix no>/DUMPFILE.UTL DISP: ENTER DISK-ID OF INPUT DISK 
<mix no>/DUMPFILE.UTL REQUIRES DATA USE ‘AX”’ 


The user must respond with the appropriate disk-ids and file-ids as they are requested. DUMPFI- 
LE.UTL will display a message as each dumpfile part is copied to a single system dumpfile followed 
by a message that indicates file reconstruction is complete. For example: 


<mix no>/DUMPFILE.UTL DISP: 
<mix no>/DUMPFILE.UTL DISP: 
<mix no>/DUMPFILE.UTL DISP: 


<mix no>/DUMPFILE.UTL DISP: 
eomiv naa /DIIMPFILE UTL DISP: 


NOGA LAU A ar aya 8 Bee A 


<mix no>/DUMPFILE.UTL EOJ 


Output Messages 


Message 


OUTPUT DISK SPACE 
EXHAUSTED — ENTER 
NEW OUTPUT DISK. 
POWER OFF OUTPUT 
DISK USING PO 
COMMAND. THEN 
INSERT NEW OUTPUT 
DISK 


NEXT FILE IN 
SEQUENCE IS 
REQUIRED. INSERT 
NEXT OUTPUT DISK. 


INVALID ENTRY 


ENTERED INPUT TOO 
LONG 


A VALID DISK-ID IS 1-7 
CHARACTERS IN 
LENGTH 
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Possible Causes 


When partitioning a large 
dumpfile, more than one mini 
disk may be required to 
accommodate all output files 
created. 


The dumpfile which is being 
reconstructed has an input file 
which is resident on another 
disk. 


This message is displayed if 
something other than one of 
the two options (‘‘P’’ or 
“‘R’’) is entered at the start 
of the program. 


An improper amount of 
characters has been entered. 


More than seven characters 
have been entered for a pack- 
id. 


<INPUT DISK-ID>/DMFILEPART00 COPIED 
<INPUT DISK-ID>/DMFILEPART01 COPIED 
<INPUT DISK-ID>/DMFILEPART02 COPIED 
<INPUT DISK-ID>/DMFILEPART03 COPIED 
FILE RECONSTRUCTION COMPLETE 


Suggested Action 


Power off all current output 
disks using PO intrinsic and 
insert a new output disk. 


Power off current input disk 
using PO SCL command and 
insert the other output disk. 


Re-enter AP for file partition or 
an R for file reconstruction. 


Check input and re-enter. 


Check the pack-id entered and re- 
enter correctly. 


Message 


A VALID FILE-ID IS 1-12 
CHARACTERS IN 
LENGTH 


NO CHARACTERS IN 
INPUT 


INVALID CHARACTERS 
IN INPUT 


A VALID FILE-ID OR 
DISK-ID MAY BE 
CONSTRUCTED FROM 
LETTERS A-Z, THE 
NUMBERS 0-9, AND THE 
SPECIAL CHARACTERS 
HYPHEN (-—) AND 
POINT (.) 


UNABLE TO OPEN 
OUTPUT FILE 
PROGRAM 
TERMINATING 


UNABLE TO OPEN 
FIRST INPUT FILE 
PROGRAM 
TERMINATING 


FILE NAME DOES NOT 
MATCH CHECK STRING 
IN FILE. FILES ARE 
EITHER CORRUPTED OR 
OUT OF ORDER 


IRRECOVERABLE ERROR 
DETECTED IN READ 


IRRECOVERABLE ERROR 
DETECTED IN WRITE 


9-88 


(continued) 
Possible Causes 


More than 12 characters have 
been entered for file-id. 


A null input was entered 
where a pack-id or file-id is 
expected. 


An invalid character was 
entered. 


Invalid characters have been 
detected in the pack-id or file- 
id entered. 


This message is displayed 
during file partitioning or 
reconstruction if 
DUMPFILE.UTL is unable to 
open the first output file. 


DUMPFILE.UTL is unable to 
open the first input file. 
(DMFILEPART00) 


Message appears when 
reconstructing a dumpfile. A 
dumpfile part on the user 
designated disk is corrupted or 
was not created at the same 
time as the first dumpfile 
part. 


A fatal error is detected when 
reading a file. 


A fatal error is detected when 
writing a file. 


Suggested Action 


Check the file-id entered and re- 
enter correctly. 


Determine input expected and 
enter it. 


Check input and re-enter. 


Check all characters entered in 
either the pack-id or file-id and 
re-enter as necessary. 


Re-execute DUMPFILE.UTL. 


If complete system dumpfile is 
still available, then run 
DUMPFILE.UTL to repartition 
the file. 


Ensure that all dumpfile parts 
were created at the same time. 


Re-execute DUMPFILE.UTL to 
reconstruct or partition dumpfile. 


Re-execute DUMPFILE.UTL to 
reconstruct or partition dumpfile. 


I 


EX (Execute) 


The EXECUTE command has an expanded use on the B 900/CP 9500. It allows the operator to start 
a program with several options from the SPO. EX can be used when the operator wishes to specify 
the amount of memory a program will need. The MCP can then assign the program to a processor 
with enough memory to run it. EX also allows the operator to substitute files before running the pro- 
gram. 


The syntax for this command is: 


a a I ge < utility, program-name, or intrinsic > —————> 
EX < disk-id > /— 


MEM —— < amount of memory > 


1\— FILE < file name in program > = <new disk-id / new file-id > 


< mfid/fid > 


The MEM option allows the operator to specify the amount of memory a program requires. This value 
is used by the MCP in determining the task processor best capable of executing the program. 


The MCP compares the total amount of memory on each task processor with the amount of memory 
specified by the operator and avoids any processor with insufficient memory. The <amount of mem- 
ory> is specified in bytes. For example: 

EX TESTPROG MEM 30000 


The FILE option allows the user to substitute files at program execution time. T he user must know 
the internal file name of the file. This can be found by looking at a source listing of the program. 


The FILE option allows a list of file names to be specified. Each file name pair must be separated 


by a comma, as the following shows: 
EX TESTPROG<FILE MYFILE = SYSPACK/YOURFILE, OURFILE = SYSPACK/THEIR- 
FILE> 


Example: 

To execute the COPY program from a disk called MYDISK, enter the following: 
EX MYDISK/COPY MEM 35000 MYPROG TO YOURPROG 

The <text> of this statement is “MYPROG TO YOURPROG”’ 


Output Message 


Message Possible Causes Suggested Action 
LOAD FAILURE ON No task processor with Re-enter specifying a smaller real 
< prog-name > sufficient memory is available. store size. 
INSUFFICIENT REAL 


STORE 
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FPP (Field Patch Program) 


The B 900/CP 9500 Field Patch Program (FPP) provides a means to update the B 900/CP 9500 release 
disks B9OORL1 and B900RL2 with system patches. This utility requires no special mix and can be run 
on any CMS system. 


After a patch has been applied to a B 900RL1 and B 900RL2 disk, the Replace function of COLD- 
START must be used to update the system disk with the patched files. 


To protect system security, FPP makes no actual changes to the release disk until all the following 
conditions are true: 


1. The following files must be present on the appropriate disk: 


File Name B900RL1 B900RL2 B900RL1 B900RL2 


SYSBLAISE 
SYSBOOTSTRAP 
SYSCOLDSTART 
SYSDSCP 
SYSHOSTLOAD 
SYSICP 
SYSINITBOOT 


All Other Disks 
B900RLI 
> 4 


| 


OK Od KS OM 


mam 


SYSMPLII 
SYSTRANSLATE 

SYSWARMSTART 
SYSBNACP 
SYSSNACP 


xx K KR KKK KK 


xm 


6 OS > 6 D> ED DO D6 


2. Every system file present on the B9OORLI (and B900RL2) disks must be at the patch level 
specified in the authorization code of the supplied patch. 


3. The patch must be entered correctly. 


NOTE 
SYSBNACP, SYSSNACP and the COBOL interpreter (SYSCOBOL) need 
not be on the release disk, but if present, they must be at the correct patch 
level in accordance with condition 2. 


The syntax for initiating this program is: 


FPP < disk-name > / < file-name > 


If no <disk-name>/<file-name> is entered, the program will look for a file named FPPPATCH 
on the system disk which contains the patch information. If this file is not found, FPP will create 
a temporary FPPPATCH file and accept the data, line by line. If a <disk-name> and < file-name > 
are supplied, the program will use that file as the FPPPATCH file. The user may create a data or 
sequence patch file with the following format: 
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me 


1. The first record of the file must be the authorization code. 

2. The subsequent records are the lines of the patch, one patch line per file record. The patch 
lines may be entered with or without spaces between the hex digit groupings. 

3. The last record of the file must contain the word END in columns 1-3. 


If a patchfile is supplied in the initiating message, FPP will execute and notify the user when it has 


completed successfully: 
<mix no>/FPP TERMINATED 


If the patch is to be entered line by line, the response to ‘‘FPP’’ as displayed on the SPO is: 


<mix no>/FPP DISP:ENTER PATCHES 
<mix no>/FPP REQUIRES DATA. USE ‘‘AX”’ 


The user responds via the ‘“‘AX’’ command with the authorization code. This code includes the check 
code, old version code and new version string. It is provided as the first line of the patch. 


The authorization code is constructed in the format: 
<check code> <old version string><new version string > 


where: 

<check code> = two groups of four hexadecimal digits. 

<old version = fourteen alphanumeric characters specifying the current release level of the 
string > files on the release disk. 

<new version = fourteen alphanumeric characters specifying the new reiease level to be 
string > given to the files on the release disk, when all files have been patched 


successfully. 


The authorization code is verified. If not valid, the user is notified and given the chance to re-enter 
the line. 

<mix no>/FPP DISP: RECORD 1 <error message> 

<mix no>/FPP DISP: FIXUP PHASE 

<mix no>/FPP DISP: <the line as entered> 

<mix no>/FPP REQUIRES DATA. USE “AX” 


FPP accepts each line of the patch in the same manner, reporting the record number of the created 
temporary file if invalid, and displaying the incorrect data. The user has the chance to correct his input. 
If the line is valid, FPP prompts the user to enter the next line of the patch. After the last line of 
the patch has been entered successfully, the user must supply: 

AX <mix no> END 


The B9OORL1 and B9O0ORL2 1 MB disks are processed in four phases. 


Example for 1 MB mini disks: 


B900RL1 Authorization Code is entered and verified and B9O0RL1 system files are 
checked for correct release level. 
B900RL2 The SYSMCP1 and SYSMCP2 files are checked for the correct level. The lines 


of the patch to be applied to the MCP (those starting with M1 and M2) are 
read from FPPPATCH or the supplied patch file. 


B900RLI1 The check codes for any patches to system files on B9OORL1 are verified and 
the patches written to those files. 
B9OORL2 The check codes for any patches to SYSMCP1 and SYSMCP2 are verified and 


the patches written. 
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RN 


When the patch has been successfully applied, the following message is displayed: 
<mix no>/FPP TERMINATED 


Output Messages 


Message 
INVALID MNEMONIC 


INVALID HEXADECIMAL 
CHARACTER 


TOO MANY PATCH 
LINES HAVE BEEN 
ENCOUNTERED 
INVALID NUMBER OF 
CHARACTERS IN PATCH 
LINE 


DISK CHECK CODE 
INCORRECT 


VERSION STRING IS 
INCORRECT 


SYSMCP!1 IS 
CORRUPTED 


<file> CANNOT BE 
LOCATED 


INVALID INITIATING 
MESSAGE 


INVALID CHARACTER 
IN INITIATING 
MESSAGE 


INCORRECT NUMBER 
OF CHARACTERS 
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~ Possible Causes 


One or both of the first two 
characters in a patch line are 
incorrect. 


A patch line contains some 
character other than 0-9 or A- 
F. Does not apply to first two 
characters in line which are 
the mnemonic. 


More lines than expected by 
FPP were entered. 


The FPP program has 
encountered more than the 
maximum 52 characters in a 
valid patch line, or less than 
the valid 10. 


The authorization code has an 
incorrect digit in the first 
eight characters, or has more 
or less than eight expected 
digits for checkcode. 


The authorization code has an 
incorrect digit in the last 28 
characters, or the version 
string in file is not that of 
authorization code. 


File is corrupted or contains 
invalid version string. 


FPP cannot find file specified 
on disk specified (or system 
disk). 

Patch filename exceeds twelve 
characters in length. 


The filename specified was 
incorrectly formed. 


Authorization code requires 36 
characters. 


Suggested Action 
Check patch and re-enter. 


Check patch and re-enter. 


Check patch and re-enter. 


Check patch and re-enter. 


Verify input, obtain correct code 
from Burroughs representative. 


Check version strings on files. 
Verify input, obtain correct code 
from Burroughs representatives. 


Verify input was entered 
correctly, check version string of 
files COMPARE file to known 
good copy or use backup patch 
disk. 


Check input, re-enter. 


Check input, rename patch file. 


Check SOG for allowable format. 


Check authorization code. 


a 


Message 


LINE CHECK DIGIT 
DOES NOT COMPARE 
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(continued) 
Possible Causes 


The entered check digit does 
not compare with the 
internally generated check 
digit. 


Filename 


SYSMCP1 
SYSMCP2 
SYSBOOTSTRAP 
SYSBLAISE 
SYSINITBOOT 
SYSCOBOL 
SYSCOLDSTART 
SYSDSCP 
SYSHOSTLOAD 
SYSMPLHU 
SYSICP 
SYSTRANSLATE 
SYSWARMSTART 
SYSBNACP 
SYSSNACP 


Suggested Action 


Check patch line of code. 
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a 
GT CF (Get System Configuration) 


This command allows the operator to display the system configuration. The following information is 
displayed on the SPO screen: 

Bus address of each processor 

Type of processor 

Amount of memory on each processor in K bytes 

Total amount of buffer memory 

Amount of data comm buffer memory 


The syntax for this command is: 


GT CF a 


Each task processor will have displayed the interpreter(s) assigned to it (for example, COBOL/MPL). 


The information displayed by this command should match the user SYSCONFIG file. If there are any 
discrepancies, the operator should request technical assistance. 


1 OS 128 
2 MPLII 256 
3: DISK 32 
4. MPLII 256 
5 COBOL/MPLII 256 
6. COBOL/MPLII 256 
8. DCP 0 64 
BUFFER MEMORY 128 
DC BUFFERMEM 40 
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GT MD (Get Full Memory Dump) 

This command allows the operator to dump the contents of memory to an internal dump file at will 
and does not require the system to be rewarmstarted. The dump file can then be printed or copied 
to another disk to be printed at a later time. 


The syntax for this command is: 
GT MD ——_——————___—_—___ 


The MCP will temporarily suspend all jobs in the mix, display the message: 
“SYSTEM DUMP INITIATED”’ 

write the contents of memory to the dump file, display the message: 
“SYSDMFILEnn CLOSED”’ 

and then resume normal mix activity. 


SYSANALYZER must now be run to convert the hex code to a readable format. 


Note that GT MD also creates a new dumpfile for a future dump. 
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GT MX (Get Mix) 


Display Mix with Task Processor Assignment 


This command allows the operator to inquire about the status of the programs currently processing 
and the task processor to which they are assigned. The syntax for initiating this command is: 


GT Mx __ 


The information displayed is the same as for a normal MX with one exception. The processor in which 


the program is executing is displayed following the program status. For example, 
01/PD B EXECUTING (PROC D) 


indicates the utility PD is executing in PROCESSOR D. The letter assigned to each task processor cor- 


responds to the letter displayed on the hexadecimal display lights in Bank A. 


Example: 
The difference in the response to the two commands is shown below: 
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MX RESPONSE 


GT 


61/PD B EXECUTIN 

03/CMSCANDE C SUSPENDED WAITING ON ACCEPT 
04/COPY B EXECUTING 

END MX 


MX RESPONSE FOR SAME MIX: 

01/PD B EXECUTING (PROC D) 

03/CMSCANDE C SUSPENDED WAITING ON ACCEPT (PROC A) 
04/COPY B EXECUTING (PROC A) 

END MX 


HN (Hostname) 


This intrinsic is used for BNA. Refer to the B 900/CP 9500 Burroughs Network Architecture Operation 
and Installation Guide (form 1163102). 


The HN intrinsic allows the user to interrogate the hostname of the local host. 


The syntax for this command is: 


HN ——________| 


Output Message 
HOSTNAME = <hostname> 
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NPC900 and NPC90OP 


The NDL post compilers are MPL programs which take an NDL S-code file as input and generate 
one or more DCP microcode files. These files are loaded in the appropriate DCP (data comm proces- 
sor) at Data Comm Subsystem (DCSS) initialization time. 


Before executing NPC, the NDL program file must be produced via an NDL compilation. 


Syntax 


< NPC option > < initiating message list > —_ 


The NPC options are NPC900 and NPC900P. NPC900 is used to generate code for use in a DCP 
equipped with a DCI line adaptor. NPC900P is used with Line Adaptor I] hardware. Both types of 
line adaptors cannot be used on the same DCP. 
The initiating messages are 

DBG 

LIST 

FILE <pack-id > / < file-id> 

WORK <pack-id> 

STATUS 

RANDOM 

DCP <dep list> 


More than one initiating message option may be entered by putting a blank space between the selec- 
tions. 


DBG 


This is the DEBUG option used for compiler debugging. It causes pertinent DCP run-time information 
to be dumped to printer. The default for this option is the suppression of the debug listing. 


LIST 


This option provides for the production of the microcode listing for each of the code files generated. 
The default for this option is the suppression of microcode listings. 


WORK 


This option forces NPC work files to specie” non-system disks. The default for this option is that 
the work files reside on system disk. 
STATUS 


This option causes the NPC to send display messages to the SPO at various times during execution. 
This option informs the operator that the program is not looping or otherwise hung. It is particularly 
useful when compiling large files with numerous terminal types. The default for this option suppresses 
all status messages. 

FILE 

This is the file equate statement. It allows the user to specify the PACK-ID/FILE-ID of the input file. 
The <pack-id> and <file-id> must conform to CMS definitions. 


NOTE 
If the FILE option is used, all generated microcode is on the specified 
<pack-id>. 


Any deviation from the defined syntax causes the termination of NPC. 
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DCP 


The DCP option allows the identification of the logical DCP for which the code file is to be generated. 
The DCPs are identified by their logical, rather than physical number, as specified in the SYSCONFIG 
file. <dcp-list> consists of the logical DCP number or several numbers separated by colons. 


RANDOM 


The NPC compiler will normally generate a random identification number and insert it in the NDLSYS 
file and the code file. This number is checked when the code file is loaded into the DCP to ensure 
that the program is compatible with the current NDLSYS file. The RANDOM option will cause the 
existing number in the NDLSYS file to be placed in the code file that is about to be generated. This 
will allow the new code file to be compatible with the code files generated in a previous execution of 
either NPC900 or NPC9OO0P. 


Examples: 


1. EX NPC900 FILE NDLCODE 
1) NPC looks for a file called NDLCODE on system disk. 
2) No listing is produced. 
3) All generated DCP files are on system disk. 


2. EX NPC900 LIST FILE USER/NDLCODE 
1) NPC looks for a file called NDLCODE on disk ‘‘USER’’. 
2) A listing is produced. 
3) All generated DCP files are on disk ‘‘USER’’. 


3. NPC900P FILE NDLSYSA RANDOM DCP (0 1) 
1) NPC900P looks for a file called NDLSYSA. 
2) Code is to be generated only for DCP 0 and DCP 1. 
3) The ID number currently in NDLSYSA will be inserted into the DCP code file(s) now being 
generated rather than calculating a new number. 


Error Messages 
The NPC emits error messages when any one of the following conditions occur: 


Firmware file exceeds memory size. Generation of the current DCP file has terminated because 
NPC has detected that it requires more memory than is 
available in the DCP (64 kB). 

Invalid S.OP An op-code located in the NDL program is not recognized 
by the NPC. The NDL program file could be computed, 
or incompatible levels of NDL and NPC have been used. 


Unable to resolve S-level branch The NDL program file has been corrupted, or a bug exists 
address in either NPC or the NDL compiler. 

Invalid physical line number The NDL source line section specifies an address outside 
detected. the range of 1-31. 

More than 16 terminal types on Firmware file references more than 16 terminals. 

file. 
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Code suppressed — terminals 
cannot run on lines 


Search RAM exceeded. 


Unsuggested S-OP 


Unresolved micro-address 
Subroutine nesting error 


In rare circumstances, due to a total lack of compatibility 
between line types and terminal types, the NPC will refuse 
to generate a codefile. For example, if all terminals were 
full duplex, but no lines specify full duplex, this situation 
will arise. 

The NDL program has encountered a hardware limitation 
on the DCP. This situation should never occur (search 
RAM maximum size is 128), but if it does, the NDL must 
be re-written. 

An NDL S-OP has been decoded and recognized but is 
unsupported on the B 900/CP 9500. 

These two messages do not usually reflect a problem with 
the NDL, but are problems with the NPCs. No action is 
necessary. 


For more information on NPC900 and NPC900P, refer to the NDL Reference Manual (form 1090925). 


9-100 


NW (Network) 


This intrinsic is used for BNA. Refer to the B 900/CP 9500 Burroughs Network Architecture Operation 
and Installation Guide, form 1163102. 


The NW intrinsic allows the user to enter text via any BNA network terminal and have this text passed 
on to the BNA Master Program. 


The syntax for this command is: 


——_ nw ———. <texr > ————_ 


Output Messages 


Message Possible Causes Suggested Action 
“NW”? IGNORED — BNA Master MCS Program Request rejected. 
SYSTEM IS NOT IN (BNAMASTER) is not 
NETWORK MODE currently in the mix and 
logged on as a programmatic 
SPO. 
“NW”? IGNORED — BNA Master’s SPO queue is Request rejected. 


BNAMASTER PROGRAM full. 
iS TEMPORARILY 

UNABLE TO ACCEPT 
COMMANDS 


The programmatic SPO header will have the input message flag set and the text length, SPO id, SPO 


tag and SPO size fields primed with the appropriate contents. The system SPO flag will be set if the 
command came from the system SPO. 
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PO (Power Off) 
The PO command allows the operator to power off the system or user disks. 


The syntax for this command is: 
< peripheral > 
FINAL 


Enter PO <peripheral> to power off a user disk. 


Enter PO SYSTEM to power off the system, if there are no tasks in the mix (NO PROGRAMS RUN- 
NING). 


Enter PO SYSTEM followed by PO FINAL if there are jobs in the mix which can be DSed. These 
two commands will DS the jobs and bring the system down. 


Output Messages 

Message Possible Causes Suggested Action 
“PQ”? IGNORED — PO <peripheral> was entered Use PO SYSTEM to power off 
SPECIFIED DEVICE IS with <peripheral> being the system, or check disk name. 
THE SYSTEM DISK — system disk. 
USE ‘PO SYSTEM”’ 
“PO FINAL”? IGNORED PO FINAL entered, but it Enter PO SYSTEM first to power 
— MUST BE PRECEDED _ was not immediately preceded off system disk. 
BY ‘‘PO SYSTEM’”’ by PO SYSTEM. 
WARNING — PO SYSTEM was entered and _ See options 1 and 2 following. 
PROGRAMS ARE IN THE a null mix condition did not 
MIX. ENTER ‘‘PO exist. 


FINAL”? TO TERMINATE 
THEM AND POWER OFF 
THE SYSTEM. 
OTHERWISE PO SYSTEM 
WILL BE IGNORED 


Option 1 


The user may complete the power off sequence despite the fact that programs are running. To do this, 
the user should enter ‘‘“PO FINAL’’. All tasks in the mix will be DSed and the system will then be 
powered off. 


Option 2 


The user may choose to exit the power off sequence and try again later. To do this, the user may 
enter any other SCL command except PO SYSTEM or PO FINAL. The user may continue processing, 
or manually terminate the programs and re-enter ‘‘PO SYSTEM’’ command. 


NOTE 
On a system for which remote operations has been enabled, only the system 
SPO is permitted to power off the system. 
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RL (Relabel) 


This intrinsic allows the operator to relabel the pack-id of any CMS disk without disturbing the con- 
tents of the disk. It also provides a mechanism for changing the name of a pseudo pack. The syntax 
for this command is: 


RL <packid > / <packid > / ——— 
WKH ro —I 


The system responds with: 
<pack-id>/ RELABELLED AS <pack-id>/ 
RL can also be done as a COLDSTART option. 


The condition required for this command to be accepted is: 
If a pseudo-pack-id is being relabelled, then all physical units that have pack-ids listed in the PPIT 
must be physically ready. 


When the pack-id to be changed identifies a physical pack, (that is, not a pseudo-pack), this command 
changes the pack-id in the disk label. Therefore, the new pack-id will be on-line. 


When the packid requested to be changed is a pseudo-pack, this command causes the entry for that 
PACK-ID in the PPIT to be changed to the new pack-id. 


WARNING 
RL does not scan the disk file header list and will neither notice nor attempt 


to correct disk file headers of dual pack file components or Key File 
Parameter Blocks (KFPBs). 


\ 


Therefore, if a file is located on two disks and one of those disks is relabelled, the disk file header 
will still locate the rest of the file under the original disk name. Also the keyfile will point to the data 
file as being located on the original disk name. 


Output Messages 


Error Message Possible Causes Suggested Action 


<pack-id> RELABELLED The command was completed None, normal operation. 

AS <pack-id> successfully. 

RL <pack-id>/<pack-id> The pack-id specified is not Re-initiate RL with valid pack-id. 
INVALID — DISK NAME _iegal. 

INCORRECTLY FORMED 


RL IGNORED — DISK The pack-id specified to be Re-initiate RL with both valid 


< pack-id > /NOT changed is not present. pack-ids. 

PRESENT 

RL IGNORED — ALL The physical unit from the RY the specified device and re- 
DISKS BELONGING TO PPIT is not ready. initiate RL. 

FIXED DISK 


ASSEMBLAGE MUST BE 
ONLINE BEFORE 
COMMAND ISSUED. 
ENSURE DISKS ARE 
POWERED ON. 


2032801 9-103 


(continued) 


Error Message Possible Causes Suggested Action 
RL IGNORED — DISK A duplicate pack condition is If possible PO the pack that is 
<pack-id> ALREADY ON detected. not being relabelled. 


SYSTEM. REMOVE/ 
RELABEL DUPLICATE 
DISK OR CHOOSE 
DIFFERENT DISK NAME 
AND RETRY COMMAND 


9-104 


RLD (Release Level Display) 


The Release Level Display (RLD) checks whether any of the following system files is present on a spe- 
cific disk, and reports the release level of each of the following files. 


A sample output is: 


<mix no>/RLD DISP: <disk-id>/SYSBLAISE — BK — RELEASE LEVEL 03.05.00 
<mix no>/RLD DISP: <disk-id>/SYSBOOTSTRAP BT — RELEASE LEVEL 03.05.00 
<mix no>/RLD DISP: <disk-id>/SYSCOBOL — CK — RELEASE LEVEL 03.05.00 
<mix no>/RLD DISP: <disk-id>/SYSCOLDSTART KS — RELEASE LEVEL 03.05.00 
<mix no>/RLD DISP: <disk-id>/SYSDSCP — DP — RELEASE LEVEL 03.05.00 
<mix no>/RLD DISP: <disk-id>/SYSHOSTLOAD HL — RELEASE LEVEL 03.05.00 
<mix no>/RLD DISP: <disk-id>/SYSICP — TK — RELEASE LEVEL 03.05.00 
<mix no>/RLD DISP: <disk-id>/SYSINITBOOT - BZ — RELEASE LEVEL 03.05.00 
<mix no>/RLD DISP: <disk-id>/SYSMCP1 — OS — RELEASE LEVEL 03.05.00 
<mix no>/RLD DISP: <disk-id>/SYSMCP2 — OS — RELEASE LEVEL 03.05.00 
<mix no>/RLD DISP: <disk-id>/SYSMPLII — MK — RELEASE LEVEL 03.05.00 


<mix no>/RLD DISP: <disk-id>/SYSTRANSLATE TR — RELEASE LEVEL 03.05.00 
<mix no>/RLD DISP: <disk-id>/SYSWARMSTART WS — RELEASE LEVEL 03.05.00 
<mix no>/RLD DISP: <disk-id>/SYSBNACP — UNABLE TO OPEN FILE 

<mix no>/RLD DISP: <disk-id>/SYSSNACP — UNABLE TO OPEN FILE 
<mx-no>/RLD DISP: <disk-id>/SYSLANGUAGE RELEASE LEVEL 03.05.00 


The information appears on the SPO screen. 


The syntax for initiating this utility is: 


<disk-id > / 


The disk that RLD is to examine for the system files is identified by <disk-id>. The default is the 
first release disk (pack-id ‘‘B900RL1’’). The pack-id for the system disk is ‘‘0000000”’ or ‘“‘SYSPACK’’. 


The Release Level Display utility searches the disk identified by <disk-id> for system files. Each file 
search succeeds or fails individually, without affecting others. 


For each file, RLD displays one of the following messages: 
<disk-id>/<fileid> UNABLE TO OPEN FILE 
indicates the file was not present on that disk. 


<disk-id>/<file-id> READ ERROR ON HEADER 
indicates the RLD utility was unable to extract release level information from the header of the indi- 
cated file. 


<disk-id>/<file-id> <mnemonic> RELEASE LEVEL XX.YY.ZZ 
identifies the disk being examined, the file found and the file release level. 
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Output Message 


Message 
INVALID PACK-ID 
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Possible Causes Suggested Action 


A pack-id was entered that Check input and re-enter. 
contains illegal characters, 

more than 7 characters, is not 

followed by a slash or refers 

to an absent disk. 


ROMANALYZER (ROM Dump File Analyzer) 


NOTE 
After taking a ROM dump, ROMCONVERT may be run to convert the 
dump to a system dump. Then SYSANALYZER may be run instead of 
ROMANALYZER. 


AfAn 


The B 900/CP 9500 ROM Dump File Analyzer, ROMANALYZER, allows the user to print 
parts, or all, of the information written on a removable disk by the Read-Only Memory (ROM 
Routine. 


ROMANALYZER can be run as a user job on any CMS system. ROMANALYZER communicates 
with the user via system accepts and displays. 


ROMANALYZER —————— <diskid > 


iw) 
=| 
3 
As) 


DESCRIPTORS 
< bus address > 


< page address > 
where: 
1. <disk-id> = disk-id of the removable disk containing the ROM dump file. The pack-id must 
identify a removable disk on which the ROM dump routine has created a dump file. No default 
is used for the dump file. 
2. DESC = print only the page descriptors. 
3. <bus address> — the ROMANALYZER must restrict itself to the pages of this bus address 
(see note). 
4. <page address> = the page on the specified bus to which the program is to restrict itself (see 
note). 


NOTE 
To specify a <bus address>, use a single hexadecimal digit between 1 and 
F. To specify a <page address>, use a single hexadecimal digit between 0 
and F. 


If a bus address appears in the initiating message (with or without a page address), ROMANALYZER 
processes the page(s) involved and issues the following ‘“ACCEPT’’ message. After processing those 
pages, the messages: 

<mix no>/ROMANALYZER DISP: <BUS><EMPTY>:, <PAGE> 

<mix no>/ROMANALYZER REQUIRES DATA. USE ‘‘AX”’ 
appear on the screen. 


When the ACPT message appears on the SPO, enter one of the following: 
AX <mix no> <bus address> 

or 
AX <mix no> <bus address>, <page address> 


ROMANALYZER continues to request additional bus/page data until a null input (AX <mix no>) 
is entered. 


ROMANALYZER Output 


The output generated by ROMANALYZER is directed to the line printer and will be in one of the 
following formats: 
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1. All descriptors and hex dumps for all pages as contained in a ROM dump file. 
2. All descriptors for all pages with no hex dumps. 
3. Descriptors and dumps for pages specified from the SPO via bus and/or page addresses. 


Page Descriptor Format 


For each page of memory in the ROM dump file, ROMANALYZER will provide the following infor- 
mation regardless of the options selected: 
1. Bus address of dump 
2. Page address of dump 
3. Size (last physical address) of dump. (If the size field has a zero value, this means one of two 
things: either the disk was exhausted while dumping that page, or the disk was removed from 
the drive prematurely.) 
. Verbal interpretation of I.C. error status (at address @FFFC@). 
. Verbal interpretation of I.C. status 1 (at address @FFFB@). 
. Verbal interpretation of I.C status 2 (at address @FFFE@). 
. Address at which dump of next memory page begins. 


SNM 


If a hex dump is selected, this information will be printed prior to the hex dump for each page. 


Each line of a hex dump that is generated by ROMANALYZER has the following format: 
<bus address>/<page address>/<hex memory address> <dump> <alphaversion> 
where: 
1. <bus address> = a single hexadecimal digit representing the bus address of the page being 
dumped (ranging from 1 to F). 
2. <page address> = a single hexadecimal digit representing the address of the dumped page 
on a particular bus address. 
3. <hex memory address> = four hexadecimal digits, representing the address within the 
specified page of the 64 bytes dumped in the given line. 
4. <dump> = a hexadecimal dump of 64 bytes. 
5. <alphaversion> = the character representation of the same 64 bytes. A byte that does not 
form a recognized ASCII character is represented by a blank. 


Examples: 


ROMANALYZER <pack-id> 
ROMANALYZER will print the descriptor and the hex dump for all pages of the ROM dump file. 


ROMANALYZER <pack-id> DESC 
ROMANALYZER will print only the descriptors for the pages generated on a particular disk. 


ROMANALYZER <pack-id> <bus address> 
ROMANALYZER will print the descriptors and hex dumps for all pages of a particular bus address. 


ROMANALYZER <pack-id> <bus address> <page> 
ROMANALYZER will print the descriptor and hex dump for a particular page. 


Output Messages 


The following messages denote irrecoverable errors encountered during processing of the dump file. 


Either the dump file was not created properly or has become corrupt. 
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Message 


***ERROR — NO 
INITIATING MESSAGE 


***ERROR — DISK NOT 
AVAILABLE 
FATAL ERROR — BUS 
PARAMETER T I 


FATAL ERROR ~— PAGE 
PARAMETER TOO LONG 


FATAL ERROR — 
INVALID BUS ADDRESS 
PARAMETER 


FATAL ERROR — 
INVALID PAGE 
ADDRESS PARAMETER 


BUS NOT FOUND 


PAGE NOT FOUND 


Possible Causes 


A pack-id was not specified in 
initiating message. 


Cannot find disk specified or 
has found a bad disk. 

A space or comma was not 
found after DESC, 
DESCRIPTORS, or the bus 
address. 


A single digit page address (0- 
F) was not found in the 
initiating message. 

The bus address specified is 
not a single hex digit between 
(1-F). 


The page address specified is 
not a single hex digit between 
(0-F). 


Specified bus address was not 
found in the dump file. 


Specified page address was not 
found in the dump file. 


**ERROR — 


**ERROR — 
**ERROR — 


] #** 


**ERROR — 


| **¥* 


**FRROR — 
SEC#** 


**ERROR — 
SECTOR*** 


**ERROR — 


2032801 


EOF READ SYSMEM, 1*** 


Suggested Action 
Re-initiate ROMANALYZER with 
a valid pack-id. 


Move disk to different drive and 
re-initiate ROMANALYZER. 


Re-initiate ROMANALYZER with 
valid bus/page address. 


Re-initiate ROMANALYZER with 
valid bus address. 


Re-initiate ROMANALYZER with 
valid page address. 


ROMANALYZER will request a 
new bus address and continue 
execution. 


ROMANALYZER will request a 
new page address and continue 
execution. 


**ERROR — LEADING SECTOR NOT 


ZERO’D OUT*** 


ERR READ SYSMEM, 1*** 
ERR SYSMEM AT.ADDR + 


EOF SYSMEM AT.ADDR + 
ERR SYSMEM INITIAL 
EOF SYSMEM INITIAL 


BAD LEADING SECTOR*** 


**ERROR — ERR IN FILE READ*** 
**ERROR — EOF IN FILE READ*** 


**ERROR — GET.RECORD READ*** 


**EOF — GET.RECORD READ*** 


DESC FOUND IN GET.RECORD 


**ERROR — TRAILING SECTOR NOT 


ZERO’D OUT*** 
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ROMCONVERT (ROM Dump File Converter) 


The ROMCONVERT utility structures the ROM dump file into a format required by the SYSANA- 
LYZER utility. The syntax for initiating the utility is: 


ROM CONVERT a | 


As a ROM dump may be spread over more than one disk, the utility will request from the operator 
the number of disks to be converted. The following messages will appear on the SPO: 
<mix no>/ROMCONVERT DISP: 
ENTER THE NUMBER OF INPUT DISKS(S) <single digit > 
<mix no>/ROMCONVERT REQUIRES DATA. USE ‘AX’ 


The operator responds, via the ‘‘AX”’’ intrinsic, with a number from one to nine. 
Example: 
AX <mix no> <number of disks> 


Next, the utility requests the pack-id of the source disk. The following messages will appear on the 
SPO: 
<mix no>/ROMCONVERT DISP: 
ENTER SOURCE DISK-ID 
<mix no>/ROMCONVERT REQUIRES DATA. USE ‘‘AX” 


The user responds, via the ‘“‘AX”’’ intrinsic, with a pack-id (conforming to CMS requirements for a 
pack-id). 
AX <mix no> <pack-id> 


Next, ROMCONVERT will request the pack-id and file-id for the creation of the converted dump file 
by displaying the following messages: 
<mix no>/ROMCONVERT DISP 
ENTER DESTINATION DISK-ID 
<mix no>/ROMCONVERT REQUIRES DATA. USE ‘‘AX” 
(RESPOND WITH ‘‘AX”’ <mix no><PACK-ID’’) 
<mix no>/ROMCONVERT DISP 
ENTER DESTINATION FILE-ID 
<mix no>/ROMCONVERT REQUIRES DATA. USE “AX’’ 
(RESPOND WITH ‘‘AX”? <mix no> <FILE-ID>’’) 


The file-id is a name arbitrarily selected by the operator. 


If the user indicated that the ROM dump is resident on more than one disk, the following messages 
are displayed on the SPO when the utility reaches the end of a disk which is less than the number 
of disks indicated: 


INPUT DISK EXHAUSTED 
REMOVE DISK USING PO SCL COMMAND 
INSERT NEXT DISK AND ENTER SOURCE DISK-ID 


NOTE 
PO SCL command refers to the PO intrinsic. 


The user should now power off the input disk, insert the disk on which the dump is continued and 
then enter the disk-id of the new disk via the ‘‘AX’’ command: 
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AX <mix no> <disk-id> 
The utility will continue until it reaches the end of the file or until another disk is required. 
The occurrence of any error sends the ROMCONVERT utility to EOJ. 
Output Messages 


Message Possible Causes Suggested Action 
INVALID — RESPONSE An invalid number was Check input and re-enter. 
MUST BE A SINGLE entered. 

DIGIT, i-9 

NO CHARACTERS IN No pack-id specified Check syntax of pack-id and re- 
INPUT enter. 

ENTERED INPUT TOO More then seven characters Check input and re-enter. 


LONG. A VALID DISK-ID — entered for pack-id or more 
IS 1-7 CHARACTERS IN than 12 characters entered for 
LENGTH. A VALID FILE- a file-id. 

ID IS 1-12 CHARACTERS 


IN LENGTH 
INVALID CHARACTER Invalid pack-id entered. Check syntax of pack-id and re- 
IN INPUT. A VALID enter. 


WOW Mm AN DY 


DiSK-iID OR FILE-iD 
MAY BE CONSTRUCTED 
FROM THE LETTERS A- 
Z, THE NUMBERS 0-9 
AND THE SPECIAL 
CHARACTERS HYPHEN 
(—) AND POINT(.). 


UNABLE TO OPEN No disk with the specified Place correct disk on line and re- 
SYSMEM pack-id is present. enter. 


The following messages denote irrecoverable error conditions encountered during processing of the 
ROM dump file: 


INPUT READ ERROR 

OUTPUT WRITE ERROR 

EOF ON INPUT 

TOO MANY BAD AREAS ENCOUNTERED 
INVALID NEXT DESCRIPTOR 

OS PROCESSOR NOT FOUND 

BAD DESCRIPTOR LOCATED 

INVALID PAGE 

INVALID BUS 
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SM (Multi-MCS Data Comm) 
The SM request causes a data comm message to be placed on the MCS queue. 


The syntax for that command is: 


The header to the message text contains, among other things, six bytes formatted as follows: 


Byte 0 Width of originating SPO (FF if programmatic SPO controls no SPOs or 
terminals). 

Byte 1 Height in number of lines for output display (FF if programmatic SPO centrols 
no SPOs or terminals; 01 if it displays to a printer). 

Byte 2 The SPO-ID of the originating SPO. 

Bytes 3-4 The tag of the originating SPO. 

Byte 5 Flags byte: 
bit 7 (most significant bit) set indicates the SPO identified in bytes 2-4 is system 
SPO. 


bit 7 reset (value = 0) indicates that SPO is not the system SPO. 
bits 0-6 are unused. 


If the program is without a SPO, bytes 0-1 will contain the size of the system SPO. 


If the SPO-ID and tag size are RRL type, the SPO.INFO fields in the data comm message header 
will contain information about the target MCS’s originating SPO, or about the target MCS. 


If bit 4 of byte 0 in the SPO.RUN header is set, this request is handled as if the RRL type were really 
a TID type tag. 


If the SPO-ID and tag are TID type, the SPO.INFO fields in the data comm message header will con- 
tain information about the SPO that issued the SM request. 
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SYSANALYZER (System Dump Analyzer) 


The B 900/CP 9500 System Dump Analyzer ““SVSANALYZER” provides a detailed analysis of a sys- 
tem dump file. 


Parameter values are supplied to SYSANALYZER via a single initiating message. The syntax of this 
message is depicted in the following railroad diagram. The options may be entered in any order. The 
analysis will still take place in the sequence in which the diagram depicts those options. 

SYSANALYZER i EEE 


MFID (< packid > } 


FID (< file-id > ) eon 
ALL 
VM 
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Examples: 


1. SYSANALYZER. If the initiating message contains no options, the system analyzer uses default 
values equivalent to the following: 
MFID (<system pack>), FID (sysdmfil00), ALL, HEX; 
To enter only SYSANALYZER, the dump file must be on the system disk and labelled 
SYSDMFILEO00. 
This syntax results in a complete printed listing plus a listing in hexadecimal of the dump file. 


2. SYSANALYZER ALL, HEX; this syntax is equivalent to example |. 


NOTE 
Only options ‘‘ALL”’ and ‘‘HEX”? are advised for analysis requested by the 
user. “‘ALL’’ produces a formatted full system analysis and a Hex dump. 
*““HEX”’ produces a full system dump. The user is advised to ignore the more 
specific analysis options unless asked to make more specific entries by a tech- 
nical expert. 


If the dumpfile is not labelled SYSDMFILE00 and/or is not on the system disk, either of the following 
syntaxes may be used: 


3. SYSANALYZER FID (THISFIL), MFID (THATPCK), ALL; 
4. SYSANALYZER MFID (THATPCK), FID (THISFIL), ALL; 


Each of the two initiating messages above will result in the same analysis. The actual sequence of 
analysis is represented by the order of the options in the second message. 


If the user enters the ‘‘FID’’ option and/or the ‘‘“MFID”’ option, with no other options following, only 
the header page and dump file information will be output by the analyzer program. 


If the “‘ALL”’ option is used, a hexadecimal dump of the disk processor is also included. 
The following table defines the various options available when initiating SYSANALYZER. More de- 


tailed information on this utility may be obtained from the B 900/CP 9500 Systems Memory Dump 
User’s Guide, form 1118478. 


Option Meaning 

MFID( ) The <pack-id> specified is the pack on which the dumpfile resides. 
FID(. ) The <file-id> specified is that of the dumpfile to be analyzed. 
ALL Perform analysis of: 


Virtual Memory (see VM) 
Operating System (see OS) 
Data Comm Processor (see DC) 
Task Processor (see TP) 
Disk Processor (see DK) 
Buffer Memory (see BM) 
VM Perform analysis of virtual memory. 
OS Perform analysis of operating system. If no suboptions are specified, all 
information pertaining to OS is given. 
Suboptions of OS: 
(A) Activity management 
(M) Memory associated with OS processor. 
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(continued) 
Option Meaning 


DC Perform an analysis of each data comm processor. If no suboptions are 
specified, all information pertaining to DC is given. To restrict analysis to 
individual DCPs, use the ‘‘BUS’’ option. Suboptions of DC: 

(DCA) Include analysis of data comm-related parts of operating system. 
(DCP) Include analysis of data comm.related parts of disk processor. 
(BUF) Include analysis of data comm-related parts of buffer memory. 


TP Perform an analysis of each task processor. To restrict analysis to individual 
task processors, use the ‘‘BUS’’ option, described below. 

DK Perform analysis of disk processor. 

BM Perform analysis of buffer management. 

VM Perform analysis of virtual memory. 

HEX Print an unformatted hexadecimal dump of the memory or memories specified. 


If no suboptions are specified, print a full hex dump of the system. 
Suboptions for HEX; 

(OS) Print a hex dump of memory associated with the operating system. 
(DC) Print a hex dump of memory associated with the data comm 
processor(s). 

(TP) Print a hex dump of memory associated with the task processor(s). 
(DK) Print a hex dump of memory associated with the disk processor. 
(BM) Print a hex dump of buffer memory. 


BUS(n) Each “‘n” is a hexadecimal character that corresponds to a given physical bus 
address. When the BUS option is specified, only the specified bus addresses 
are considered to be in the dump file. 


The ‘“‘BUS(n)’”’ option allows analysis of the specific task processor(s) or data comm processor(s) that 
the user wishes to examine. When this option is not used, all task processors are analyzed as a result 
of TP; all data comm processors are analyzed as a result of DC. 


The OS processor memory must be available if the ‘“DC(DCA)”’ or “VM” option is specified. To do 
a complete analysis of a DCP when the ‘‘BUS(n)’”’ option is used, the bus address of the OS processor 
must be specified as well as the bus address of the given DCP. 


The “BUS (n)’”’ option may be used together with the ‘“ALL”’ option. This causes a comprehensive 
analysis, but only of the bus addresses specified. 


SYSANALYZER Error Messages 


An error detected in the dump file by the analyzer, or an error in the analysis, causes an error message 
to be generated within the analysis printout. These error messages are bracketed by strings of ‘$$$’ 
before and after the message (that is, ‘“$$$ ERROR MESSAGE $$$”’). Messages not bracketed in this 
manner are merely warnings. 
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SECTION 10 
B 1800/B 1900 DEPENDENT SYSTEM SOFTWARE 


CMS INTRINSICS 


With the exception of the following, the intrinsics are as defined in section 3 Common Intrinsics. 


SA Set ASCII — output to all devices for which translation is approved is in ASCII code. 
SE Set EBCDIC — output to all devices for which translation is approved is in EBCDIC 
code. 


For both the intrinsics, the approved devices are line printer and magnetic tape. There are no response 
messages to this translation switch being set either way. There are no means for the user to determine 
what the setting is, so, to be sure, the option required should be entered explicitly. 


Intrinsics AP, FD, ND, and VF are defined but are not implemented in B 1000 systems. 


Intrinsics CTL, HELP, LI, LO and CS have not been defined and are treated as user programs if 
entered on the SPO. 


LT on B 1000 systems is a utility for loading translation tables to a chain type printer — see LT later 
in this section. 
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CMS UTILITIES 
CONFIGURER 


This utility creates and modifies the file ““SYSCONFIG’’. Much of the information in SYSCONFIG 
is only used at CLEARSTART. However, some options may be acted on in the current session. If 
an item :aay have an effect in the current session, this is noted in its description. All information re- 
lated to the Data Communications Sub-System (DCSS) is used at DCSS initiation. The SYSCONFIG 
file must be present on the system disk in order to CLEARSTART. 


Syntax 


The format of the initiating message is as follows: 


CONFIGURER MFID <sysconfig pack-id > <s/r variant > <option > 


The MFID option specifies the location of the SYSCONFIG file. 


<s/r variant>: 


SET Causes an option to be set on. 
RESET Causes an option to be set off. 
SO Equivalent to SET. 

RO Equivalent to RESET. 


If not specified, the default is SET. 
<option>: 
AREASIZE <num> _ Enables the user to specify (in sectors) the minimum size of a disk area 


when several areas are to be created for a single file. SET and RESET 
need not be specified. 


COUNT Gives the number of CLEARSTARTs performed since the creation of 
SYSCOMNFIG file. Automatic — cannot be set or reset. 
CREATE Enables the user to create the file SYSCONFIG. 


Any existing file on the required pack is then removed, unless its file type 
value is not the standard @22@ value. In this case, a warning message is 
issued (see error messages). 

The CREATE option is always the first executable option. SET and 
RESET are not valid for it. 


CYCLE Prevents consolidation of the system messages into secondary log files. 
When a primary log file is filled up, it is reused, that is, overwritten. 
Even if CYCLE is set on, all maintenance message entries are consolidated 
into a secondary file. 


DATE It is advisable to keep these options set on in order that the MCP 
TIME maintains the correct system date and time. 


10-2 


ig a eee 


DCPDUMP< num > 


DCSIZE <num> 


DISPLAY 


ERRLOG 
HELP 


LIST 


LOG 


LOG.PID 
<pack- id> 


MASK @XXXX@ 


2032801 


SO DATE and/or SO TIME cause the date and/or time messages to be 
displayed on the SPO at CLEARSTART. 

If DATE or TIME is reset, the current system date and time are stored in 
SYSCONFIG and used at the next CLEARSTART. 


This datacomm option takes effect the next time datacomm is initiated in 
this session, or in a subsequent session. If set, instead of the MCS being 
loaded, the DCP <num> specified will have its memory dumped to a file 
called DUMPDCP<num> on disk. When the DCP has been dumped, the 
option is reset automatically. When set, the message DUMP ON DCP x 
appears in the DISPLAY, PRINT, or LIST option responses. For the SPO 
DCP on B 1990 systems, use the option SPODUMP. 


This datacomm option specifies the amount of memory allocated for the 
datacomm message area in K bytes, at datacomm initiation time, in this 
session, or in a subsequent session. 

<num> must be in the range 5 to 310. 

SO and RO are not valid for this option. 


Causes a description of the SYSCONFIG file to be displayed on the SPO. 
SET and RESET are not valid for this option. 


This option switches maintenance logging on or off. 


Causes the syntax diagram for CONFIGURER to be listed on a line 
printer. 

SET and RESET are noi valid for this option. 

Causes a description of the file SYSCONFIG to be either listed or written 
into a backup file. 

SET and RESET are not valid for this option. 


Controls whether the logging facility will be initiated at CLEARSTART. 
SO LOG causes logging to be initiated at CLEARSTART. 

RO LOG inhibits logging, except the logging of hardware maintenance 
entries. When this option is reset, log file information is not displayed by 
a CONFIGURER PRINT or DISPLAY. The message ‘“SSPO LOGGING 
OFF”’ appears. 


Enables the user to specify the pack on which the log files will reside. 
SET and RESET are not valid for this option. 


Where @XXXX@ is a 4-digit hexadecimal number representing the 
Channel Mask. 

RO MASK supplies the value @FFFF@ to the SYSCONFIG Channel 
Mask (all channels are thus enabled). 

SO MASK @XXXX@ gives the value XXXX to the Channel Mask. This 
represents, from right to left, the numbers of the channels wanted to be 
used by the system. 

Example: SET MASK @0203@ enables the MCP to handle only channels 
0, 1 and 9. (the mask setting corresponding to the binary setting 
@0000001000000011@). 

This setting is stored in the SYSCONFIG file and recalled at each 
CLEARSTART time unless another mask value has been supplied via the 
RO MASK option. 

Note that setting the maintenance panel toggles at CLEARSTART time, 
with the value @FA@ in the first two digits, and a mask value in the 
four last digits, takes precedence over the SYSCONFIG mask. 
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MAXAREAS Sets the maximum number of areas per disk file. The maximum value 


<num> allowed for <num> is 16. SET and RESET need not be specified. 

MAXUSERS Sets the maximum number of concurrent users of a non-shared disk file. 

<num> The maximum value allowed for <num> is 63 and the minimum value is 
7. SET and RESET need not be specified. 

MESSAGE FILE Enables the user to specify the desired message file. 

< file name> 

PRBK — PRBK ON TO < disk-id > < file-size > 


Controls how the backup file option is set at CLEARSTART. 

<disk-id> denotes the pack on which backup files are to be created and 
searched for. 

<file size> denotes the maximum size of a backup file. 

SO PRBK... sets the backup file option at CLEARSTART causing backup 
files to be created. 

RO PRBK... resets the backup file option at CLEARSTART. 

When this option is reset, backup file information is not displayed by a 
CONFIGURER PRINT or DISPLAY. 

When creating a printer backup file, the <file size> contained in 
SYSCONFIG will be used IF AND ONLY IF the file size of the output 
file originally directed to the printer has a value of 0. 

Any other value will be used as a file size for the printer backup file and 
may cause an unexpected DS/DP of the program when that file size is 
exceeded. 


NOTE 
The printer backup options may be changed dynamically at run time using 
the SO intrinsic. 
PRINT Generates a listing describing the SYSCONFIG file. 
SET and RESET are not valid for this option. 
RECONFIGURATION _ This option allows the user to modify the network configuration, using the 
appropriate MCS commands. 


RELEASE.LEVEL Gives the release level that will be used for documentation a SET and 
RESET need not be specified. 


REMOTECHAR Specifies the control character for REMOTE SPO activities. 
<char> <char> denotes the desired character. 

SO and RO need not be specified. 
REMOTEFLAG Controls whether remote SPO activities will be allowed or inhibited. 


SO REMOTEFLAG sets the REMOTEFLAG at DCSS initialization, 
allowing REMOTE SPO activity. 

RO REMOTEFLAG resets this flag at DCSS initialization, inhibiting 
REMOTE SPO activity. 

When this option is reset, the message “‘REMOTE SPO OFF”’ appears in 
a CONFIGURER DISPLAY or PRINT. 


REMOVE Transforms all non-conditional CLOSE LOCK into CLOSE REMOVE. 
Set this option with caution. 


SAVE Causes the line printer to be saved when current printing terminates. It 
takes effect immediately. 
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SHARED FILES 
<num> 


SPO ADDRESS 
<numi : num2> 


SPO DUMP 


SYS-LOG FILES 
SIZE <num> 


SYS-HLD FILES 
SIZE <num> 


SYS-MLG FILES 
SIZE <num> 


TEACH 


TIME 
WRITE 


ZIP [‘‘<text>”’] 
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Sets the maximum number of shared files that can be opened. 

The maximum value allowed for <num> is 255, and the minimum value 
is 32. 

SET and RESET need not be specified. 


Specifies the line on which the system SPO resides 
where num! = DCP number 

num2 = line number of the specified DCP. 
Normally this is 0:0 and should remain so because this is what the stand- 
alone programs expect. This option may only be specified for B 1990 
systems. 


Causes the memory of the SPO DCP to be dumped to a reserved area 
during the next CLEARSTART. This option may only be specified for 
B 1990 systems. 


Sets the size, in sectors, of the four primary log files named SYS-LOG- 
NN (the range of NN is 01-04). 

<num> is a decimal number from 32 to 16383. 

The SYS-LOG-NN files are single area files. 

SET and RESET are not valid for this option. 


Sets the size, in sectors, of the secondary system files, that is, the log files 
created and maintained by TL in order to receive system entries for 
consolidation. 

<num> is a decimal number from 32 to 262140. (See NOTE below.) 
These files are not created if CYCLE is set on. 

SET and RESET are not valid for this option. 

NOTE: While CONFIGURER allows setting a file size > 262140 sectors, 
TL is unable to open such a file, as its size would exceed the maximum 
CMS file size of 1048560 records. In this case, TL goes to a DS/DP 
condition, for the following reason: 

On disks with the allocation unit not equal to 1, the maximum value of 
262140 sectors would result in a file greater than the CMS maximum of 
1048560 records. 

For such disks, the maximum size is the number of allocation units 
rounded down. 


Sets the size, in sectors, of the secondary maintenance files, that is, the 
log files created and maintained by TL and which receive the maintenance 
entries and the hardware configuration area. 

<num> is a number from 32 to 262140 (see note for SYS-HLD FILES 
SIZE). 

These files are created for consolidation whether CYCLE is set on or off. 
SET and RESET are not valid for this option. 


Causes the syntax diagram for CONFIGURER to be displayed on the 
SPO. 
SET and RESET are not valid for this option. 


See DATE option. 


Causes a backup file to be created with the description of the 
SYSCOMFIG file. 
SET and RESET are not valid for this option. 


Indicates a message, <text>, to be ZIPPED after CLEARSTART. 
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““<text>’’ denotes the message to be ZIPPED and must be a quoted 


String. 


SO ZIP ‘‘<text>” sets the message to be ZIPPED. 

RO ZIP resets the message to null. When this option is reset, no ZIP 
message will appear in a CONFIGURER PRINT or DISPLAY. 

This facility is very convenient as it can be used to zip an MCS 
automatically after each CLEARSTART. 


The SAVE FACTOR output by options PRINT or LIST gives the compile date of the version of CON- 


FIGURER which created that SYSCONFIG. 


Defaults 


The values of the SYSCONFIG file included in the 3.05 release are as follows: 


SPO LOGGING ON 
CYCLIC LOGGING OFF 
PRIMARY LOG FILES SIZE 256 @100@ 
SECONDARY LOG FILES SIZE 256 @100@ 
MAINTENANCE LOG FILES SIZE 256 @i0@ 
MESSAGE FILE NAME SYSLANGUAGE 
DATE ON 

TIME ON 
RELEASE LEVEL 3.05.00 
REMOVE OPTION OFF 
ERRLOG OPTION ON 

SAVE DEVICE OPTION OFF 
REMOTE SPO ON 
RECONFIGURATION ON 
REMOTE CHARACTER * 

CLEAR START COUNT 0 

DC BUFFER SIZE 32 @20@ 
AREA SIZE 256 @100@ 
BACKUP DESIGNATION 0000000 


BACKUP FILE SIZE 


10000 @2710@ 
2 


NUMBER OF SHARED FILES 3 
MAX USERS 63 
SPO ADDRESS 0:0 
SPO DUMP ON 
Other datacomm information is reset. 
ZIP information is reset. 
The backup option, PRBK, is reset. 
Update Messages 

NOTE 


If the option you are entering is already set, the response message is: 
*“*<packid >/SYSCONFIG”’ OK. 


REMOTE FLAG SET [RESET] (REMOTE CHARACTER : “x"’) 
RECONFIGURATION FLAG SET [RESET] 
REMOTE CHARACTER ‘‘x’”? CHANGED TO “ty”? 
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DC BUFFER SIZE CHANGED FROM xx K-BYTES TO yy 

MESSAGE FILE NAME ‘‘xxx’? CHANGED TO “yyy” 

SPO LOGGING SET [RESET] (LOG FILES SIZE : xxxx SECTORS 

HLD FILES SIZE : 256 SECTORS, MLG FILES SIZE : 256 SECTORS) 

DUMP DCPx SET [RESET] 

BACKUP OPTION SET [RESET] (BACKUP DESIGNATE DISK : ‘‘<packid>”’, 
BACKUP FILE SIZE = xxxxx RECORDS 
if “TO. <diskid>”’ option is specified, the r 
‘<< packid>’?’ CHANGED TO ‘‘<diskid>”’ 
If <file size> option is specified, the response message is: BACKUP FILE SIZE CHANGED 
FROM xxxxx RECORDS to yyyyy RECORDS 

ZIP MESSAGE RESET 

ZIP MESSAGE CHANGED TO ‘“ < zip text > ”’ 

CHANNEL MASK CHANGED FROM < xxx > TO < yyy > [RESET] 

REMOVE OPTION SET [RESET] 

ERROR LOGGING OPTION SET [RESET] 

SAVE DEVICE OPTION SET [RESET] 

CYCLIC LOGGING SET [RESET] 

MAX. USERS CHANGED FROM < xxx > TO < yyy > 

MAX. AREAS CHANGED FROM < xxx > TO < yyy > 

MAX. NUMBER OF SHARED FILES CHANGED FROM < xxx > TO < yyy > 

SPO DUMP SET [RESET] 

SPO ADDRESS x:x CHANGED to y:y 


o 
Gn 
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Error Messages 


CANNOT OPEN < mfid/fid > FILE TYPE MISMATCH 


< mix/prog > 

< mix/prog > CANNOT OPEN < mfid/fid > PACK NOT PRESENT 

< mix/prog > CANNOT OPEN < mfid/fid > DIRECTORY FULL 

< mix/prog > CANNOT OPEN < mfid/fid > INVALID FILE NAME 

< mix/prog > WAITING OPEN ON < mfid/fid > IN USE 

< mix/prog > CANNOT OPEN < mfid/fid > DISK LOCKED 

< mix/prog > CANNOT OPEN < mfid/fid > BAD BLOCK OR RECORD SIZE 
< mix/prog > CANNOT OPEN < mfid/fid > BAD FILE SIZE 

< mix/prog > CANNOT OPEN < mfid/fid > FETCH VALUE :@XXXKXXX@ 
< mix/prog > WAITING CLOSE ON < mfid/fid > DUPLICATE FILE 

< mix/prog > CANNOT CLOSE < mfid/fid > FILE TYPE MISMATCH 

< mix/prog > CANNOT CLOSE < mfid/fid > FILE IN USE 

< mix/prog > CANNOT CLOSE < mfid/fid > DISK LOCKED 

< mix/prog > CANNOT CLOSE < mfid/fid > FETCH VALUE @XXXXXX@ 
< mix/prog > DATA ERROR ON READ FROM < mfid/fid > —RECORD XX 
< mix/prog > INVALID KEY ON READ FROM < mfid/fid > —RECORD XX 
< mix/prog > CANNOT READ < mfid/fid > -—RECORD XX FETCH VALUE 
@XXXXXX@ 

< mix/prog > PARITY ERROR ON WRITE TO <mfid/fid > —RECORD XX 
< mix/prog > NO USER DISK TO CREATE < mfid/fid > 

< mix/prog > CANNOT CREATE < mfid/fid > — DISK LOCKED 

< mix/prog > INVALID KEY ON WRITE TO < mfid/fid > —RECORD XX 


< mix/pros > CANNOT WRITE < mfid/fid > -RECORD XX FETCH VALUE 
@XXXXXX@ 
< mix/prog > INVALID NUMBER OF LOG FILES 
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mix/prog 
mix/prog 
mix/prog 
mix/prog 
mix/prog 
mix/prog 
OPTION 


NANANAAA 


> 
> 
> 
> 
> 
> 


INVALID LOG FILE SIZE 

INVALID DCP NUMBER 

INVALID DC BUFFER SIZE 

INVALID BACKUP FILE SIZE 

INVALID REQUEST ( < option > ) 

““< mfid/fid >’? VERSION NUMBER MISMATCH -— TRY ... “CREATE” 


These messages are self explanatory. 


When a SYSCONFIG file already exists on a pack and an attempt is made to CREATE a new SYS- 
CONFIG file on the same pack, the previous one will be removed unless its file type value is different 
from @22@. In this case the following messages are issued: 


< mix/prog > ** WARNING ** < fid > ALREADY PRESENT ON < mfid > FILE TYPE 


IS @XX@ 


< mix prog > ACPT ( ANSWER ‘‘OK” OR ELSE ) 


By answering “‘OK’’, the user gives CONFIGURER the authorization to remove the previous SYS- 


We 


CONFIG file. 


By entering any other answer, he prevents the removal of the previous SYSCONFIG file. 


Warning Messages 


mfid/fid 
mfid/fid 
mfid/fid 
mfid/fid 
mfid/fid 


ANAAA 
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> 
> 
> 
> 
> 


REMOVED 
CREATED 
UPDATED 
LISTED 
OK 


DC.INFO 


The DC.INFO utility provides the user with a means of getting in-flight information about any of the 
DCPs which have been loaded. 


Invoking this program creates a Dump file of the requested DCP memory, which can be analyzed by 
the DCP.ANALYZER utility. 


Syntax 
DC.INFO DUMPDCP <num> 


where <num> represents the logical number of the DCP. Its value is an integer from 0 to 4, which 


is assigned in order of the occurrence of the DCP in the Channel Table, that is, the channeis are 
scanned in numerical order (0 to 15) and the first DCP found becomes DCP 0, and so on. 


Error Messages 

Syntax errors cause the following message to be displayed: 
VALID INITIATING MESSAGE IS DUMPDCP X 

If the DCP for which a dump is requested is not connected, the error message is: 
INVALID DCP NUMBER 

If the DCP for which the dump is requested has not been loaded, the error message is: 
CANNOT DUMP DCP<X> NOT IN USE 

Completion Message 

After the dump file has been successfully created, the message: 
DUMPDCP <num> created 

is displayed and the dump can be analyzed via DCP.ANALYZER: 


DCP.ANALYZER FILE DUMPDCP<num> DUMP (see DCP.ANALYZER notes) 
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a ae ee 
DCP.ANALYZER 


A Data Comm problem can arise from a problem in the DCP itself. A DCP dump must then be taken 
and properly analyzed by DCP.ANALYZER. 


How To Take A DCP Dump 


There are three ways to get a DCP Dump: 
1. Take an ‘“‘in-flight’” DCP Dump by invoking DC.INFO (see DC.INFO notes). 


2. Set DCPDUMP in SYSCONFIG (see CONFIGURER notes). In this case, the dump(s) will be 
taken at the next Data Comm initialization time. This will cause DCCH to go to End of Job 
without executing the requested MCS. The options corresponding to the relative position of the 
DCP dumped will be reset in SYSCONFIG, and it is the responsibility of the operator to restart 
the Data Comm Sub-System. 


NOTE 
If DCPDUMP is to be taken after a system hang or halt: 


~ on conventional B 1000 systems, do not press CLEAR button, press START 
button only. 
- on B 1990 systems do not use MTR GO, use TAPE GO. 


How To Analyze A DCP Dump 


DCP.ANALYZER analyzes dumps created from either DCP-1, DCP-3 or DCP-4. Two modes of oper- 
ation are provided: interactive mode and batch mode. 


Interactive mode is invoked by not specifying an initiating message and may be used from either the 
SPO or a terminal. DCP.ANALYZER may be used with either a GEMCOS or TMCS interface. 


The user may examine (display) and/or print selected portions of dump information using the com- 
mands provided. 


Syntax 
DCP.ANALYZER (from the SPO) 


or 
<MCS control char> DCP.ANALYZER (from a terminal) 


Two kinds of reserved words are used by DCP.ANALYZER: 


1. The Commands to specify an action to be executed, usually a file related function. 
2. The Formatters to generate output formats. 


Commands and formatters are entered by using AX messages via the SPO or directly from a terminal. 
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$n a 


If the output takes more than a page, then ‘‘...’? appears at the bottom left hand corner of the screen, 
and the user must send a blank input to get the next page. For a terminal the cursor is positioned 
to send one space character. 


A HELP function will be invoked if an entry, not recognized as a reserved word, is entered. 


In batch mode, entered by specifying an initiating message, all output is printed. The user can choose 
which portions of the dump information are to be printed, or he may print the entire dump. 


The initiating message syntax is: 


——— FILE < dump file name > eet t aia are 


PRINT 
where <dump file name> is the name of the DCP dump file to be analyzed and <formatter> is 
one of the formatters defined below. 
Example: 
To print the entire dump of DCP 0: 
DCP.ANALYZER FILE DUMPDCPO0 DUMP 


Commands and Formatters 


BYE CONFIGURATION 
CLOSE PRINTER DUMP 
DCP-1 LIEGE.HDR 
DCP-3-4 LINE 
DISPLAY LINE.HISTORY 
END LINE.INFO 
FILE LINE.LINKAGE 
FORMS LINE.TABLE 
GET LIST.AVAIL 
HELP LIST.MSG 
PRINT LIST.QUEUE 
WHAT LIVM.HDR 
NETWORK 
RESV.MEM 
STATION 


STATION.HISTORY 
STATION.TABLE 
SUMMARY 
Each command and formatter is defined below. 
Where a numeric parameter or address is required, the value may be specified in two ways: 
1. Decimal, for example, 255. 
2. Hexadecimal, by specifying the hexadecimal value IMMEDIATELY after the special character 
‘‘@’’, for example, @FF. 
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ee en se 
BYE 


This command is used to exit the interactive mode. 


CLOSE PRINTER 


When a print is requested, the analyzer opens a printer file and keeps it open until End Of Job. The 
CLOSE PRINTER command allows the user to close the printer file without terminating the analyzer 
job. 


CONFIGURATION 


This formatter outputs the hardware line configuration of the DCP. It is a table describing all the line 
adapters found on that DCP (some of them may be unused by the NDL). 


DCP-1 


This command is used when the program cannot determine the type of dump file to be analyzed. The 
DCP-1 type will be forced. 


DCP-3-4 


This command is used when the program cannot determine the type of dump file to be analyzed. The 
DCP-3 or DCP-4 type will be forced. 


DISPLAY 


This command may be used to display the dump file contents in hexadecimal or disassembled micro 
code. 


DISPLAY <formatter> used in interactive mode will display the selected format but is redundant, 
since entering <formatter> only will give the same results. 


The full syntax, common for DISPLAY and PRINT, is: 


< formatter > 
HEX 


PRINT 
DISPLAY 


TO < address > 


< address > 


FOR < length > 


BDS 


The type code HEX, Z80 or BDS specifies the format desired: 
HEX for hexadecimal memory contents. 
BDS for disassembled DCP-1 code. 
Z80 for disassembled DCP-3 or DCP-4 code. 
The default is the last type used, or HEX if no type has previously been specified. 


The dump range may be specified from a start address to an end address or from a start address for 
a specified number of bytes. If only a start address is specified, a length of 255 bytes is assumed. 
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DUMP 


This formatter will output all information for the file loaded. It successively executes the following 
formatters: 


SUMMARY 

CONFIGURATION 

NETWORK 

LINE.LINKAGE 

RESV.MEM 

LIST.AVAIL 

LINE for each line declared in the NDL for the related DCP 


END 


This command is used to exit the interactive mode. 

FILE <file-name> 

This command is used to open the specified file and select it as a DCP-1 or DCP-3 dump file with 
the message ‘‘DCP-n DUMP FILE LOADED”’. If the dump type cannot be determined, the message 


‘“CANNOT DETERMINE DCP DUMP TYPE”? is displayed and the dump type can be selected by 
the user via the use of the DCP-1 or DCP-3-4 commands. 


If the file cannot be opened, the message ““CANNOT OPEN <fid> [<n>]’’ is output where <n> 


: at fal oe eee Se eee bt aL wo hn Eriteean 
is the UMS event number indicating te Treason OF LHe laure. 
FORMS 


This command will display all the formatters available, adding DCP-1 and DCP-3-4 to the list. 
GET <file-name> 


This command is the same as the FILE command. 
HELP 


This command will interactively display explanations on the analyzer program, all the available com- 
mands and formatters. 


LIEGE.HDR <addr> 


The Liege header found at the specified address is output. The Liege header is B 1000 systems imple- 
mentation dependent. 


LINE <IIn> 


LINE <memory address > 


This formatter takes a parameter which is either a logical line number or the memory address of the 
line info table. The line info table, the line table and each attached station table is provided. 
LINE.HISTORY <lin> 


All message headers found in the available list referring to the logical line number specified are output. 
Since the buffers are allocated cyclically, these messages provide a history of activity on the line. 


Following the messages, the line info table, line table and station tables for each attached station are 
output. 
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LINE.INFO <IIn> 
LINE.INFO <memory address> 


The parameter may specify either a logical line number or the memory address of the required line 
info table. If memory address is specified, the user must ensure that it addresses a valid line info table. 


The line info table format printed is B 1000 systems implementation dependent. 


LINE.LINKAGE 


This formatter outputs the structure of links between ready lines. 
LINE.TABLE <lIn> 
LINE.TABLE <memory address> 


The parameter may specify either the logical line number or the memory address of the required line 
table. 


If a memory address is specified, the user must ensure that a valid line table address is specified. 
y 


The format of the line table printed is as specified for the NDL S-Machine and is documented in the 
Data Comm Subsystem Reference Manual, form no 1090909. 


LIST.AVAIL 


This formatter outputs the list of all available buffers in the DCP memory. When present, the message 
header of each buffer will be output. 


Since the available buffer pool is allocated cyclically, the list of available buffers is a dynamic history 
of messages in the approximate order that they were processed. 


LIST.MSG <addr> 


The message header (LIEGE.HDR and LIVM.HDR) and the beginning of the message text found at 
the specified address is output. If the message is longer than 61 characters, there are a few ‘“‘...”’ at 
the end of the line. 


LIST.QUEUE <addr> 
This formatter outputs the list of all the messages in the queue located at the specified address. 
LIVM.HDR <addr> 


The LIVM header found at the specified address is output. The LIVM header is defined for the NDL 
S-machine, and is documented in the CMS Data Comm Subsystem Reference Manual, form no 
1090909. 


NETWORK 


This formatter provides information on the line configuration defined in the NDL program for the 
related DCP. 


PRINT 


This command is similar to the DISPLAY command but the output generated is directed to a printer. 
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Refer to DISPLAY for the complete syntax. 


PRINT <formatter> option used in batch mode will print the selected format but is redundant, since 
entering <formatter> only will give the same results. 


RESV.MEM 


This formatter will output information regarding the state of the DCP and HOST interface at the time 


af +n JA. 
Or tne auimp. 


The reserved memory format printed is B 1000 system implementation dependent. 
STATION <!sn> 


STATION <memory address> 
The parameter may specify either a logical station number or the memory address of a station table. 
If a memory address is specified, the user must ensure that it is a valid station table address. 


The station table is output together with any messages queued in the station queue. 
STATION.HISTORY <Isn> 


All message headers in the available buffer pool referring to the logical station specified are output. 
Since buffers are allocated cyclically, the list of messages provides a history of station activity. 


Following the messages, the station table and station queue are output. 
STATION.TABLE <Isn> 
STATION.TABLE <memory address> 


The parameter may specify either a logical station number or the memory address of the required sta- 
tion table. 


If a memory address is specified, the user must ensure that it is a valid station table address. 


The selected station table is output. 
SUMMARY 


This formatter outputs information regarding the generation of the DCP code file and also about the 
physical configuration of the lines on the DCP. 


WHAT 


This command will give information about the version level of the DCP.ANALYZER used and about 
the dump file analyzed. 
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DISKDUMP 


The aim of the DISKDUMP utility is to make the B 1000 system more secure and to allow the user 
to install a straightforward recovery procedure. For that purpose it enables the user to get a quick on- 
line backup of a CMS disk. This backup is created on another CMS disk, but can transit via a tape. 


Allowed disk devices are DP205, DP206, DP207, DP223, DP225. 


Any program will execute normally provided it resides and accesses files on a disk other than the disk 
used as input to DISKDUMP. 


For programs residing or accessing files on the input disk: 
— if they are started before DISKDUMP, they may go on executing as long as they do not access 
SYSMEM, as SYSMEM is locked during the DISKDUMP run (so no access is allowed to the avaii- 
able table or disk file headers for modification of area allocation). 


— an attempt to start them during the DISKDUMP execution will fail and the message ‘“‘DISK 
<packid> IS CURRENTLY LOCKED BY ANOTHER PROGRAM”’ will be displayed. 


The utility works in three phases: 


1. A dump phase. 

2. A comparison phase, which is automatically performed if I/O errors occur during the dump 
phase and which can be requested otherwise. 

3. A copy phase which is executed if comparison errors are detected during the comparison phase 
(see paragraph entitled comparison errors). 


Three functions are provided: 


1. DSKDSK for a copy from disk to disk. 
2. DSKMTP for a copy from disk to tape. 
3. MTPDSK for a copy from tape to disk. 


To each one of these functions may be added the comparison function: 


AND COMPARE 
The input file is named <input device id>/SYSMEM, the output file is named <output device id>/ 
SYSMEM. 
NOTE 
As DISKDUMP works on a sector basis, one record represents one sector. 


DSKDSK 


The data in every sector of the input disk is moved into the corresponding sector on the output disk. 
When completed, both disks are identical, except for the output disk serial number, initialization date 
and owner’s identification fields which are preserved if it was a CMS disk. In addition, the output 
disk name may be specified in the initiating message. 


For error handling, see the following paragraphs. 
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DSKMTP 


Every sector of the input disk corresponds to a record on the output tape. A bad sector on the disk 
produces a tape record filled with the error pattern ‘“‘BADBAD...”’ 


MTPDSK 


Every record on the input tape is moved into a sector on the output disk. First data record on tape 
must be a copy of the CMS disk label. 


A bad sector on the output disk is skipped, and the corresponding record from the tape is not copied. 
AND COMPARE 
Every record on the output device is compared with the corresponding record on the input device. 


This phase is automatically invoked if it is specified in the initiating message, or if I/O errors occur 
during the dump phase. If not, the user is asked if he wants a data comparison: 


DATA COMPARISON CHECK ? <YES — NO> 


During the comparison phase, DISKDUMP memorizes the numbers of the records affected by I/O er- 
rors and identifies the files that were not copied correctly. 


Unlabelled Open 


If the output device is a disk, an unlabelled open is performed on it. If the input device is a disk, 
and the COMPARE option is specified, an unlabelled open is performed if it is not the system disk. 


An unlabelled open in this context requires the operator to reserve the disk using the RD command, 
then assign it to DISKDUMP using the AD command. 


The following messages are displayed in this case: 


< mix/DISKDUMP > : SELECT <input — output> DEVICE, USING THE .. 
.. FOLLOWING COMMANDS : 


< mix/DISKDUMP > : RD <DEVICE MNEMONIC> 
< mix/DISKXDUMP > : AD <MIX> <DEVICE MNEMONIC> 


Program Initiation 


TEACH 


DISKDUMP DSKDSK 


DSKMTP 


AND COMPARE 
& COMPARE 


MTPDSK 


< output dev-id > NO DISPLAY (RETRY nn) 
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>—_—— <input dev-id > —— TO 


a ee ee 
NODISPLAY prevents ‘the display of the COMPARISON error messages. 


(RETRY nn) enables the user to set the maximum number of retries when a recoverable input 
error occurs. nn is an integer among [1, 2, 4, 8, 16, 32, 64]. If another integer, or no integer 
is specified, the number of retries is 24. 


The TEACH option shows a simplified initiating message, omitting the TEACH, NODISPLAY and 
RETRY options. 


BOJ Messages 
<mix>/DISKDUMP B1900 VERSION [ <compile date> ] BOJ AT hh:mm:ss 


<mix>/DISKDUMP INPUT DEVICE = “ device-id SYSMEM ” < peripheral type> 
OUTPUT DEVICE = “‘ device-id SYSMEM ” <peripheral type> 


Error Handling And Error Messages 
Bad Sector Count In Label 


If the Bad Sector Count field in the label of an input or output disk is not zero, the program will 
display a message asking whether or not the operator wishes to continue. To continue, the operator 
replies using the AX command. If the reply is ‘‘N’’ the program goes to End Of Job. 


Comparison Errors 


Any discrepancy found between two records during the comparison phase causes the utility to display 
the following messages: 


< mix/prog> COMPARISON ERROR AT RECORD <xxxx> STARTING AT BYTE <yy> 


< mix/prog> : INPUT ( OUTPUT ) ERROR ON < pid > AT SECTOR <xxxx> 
ooh AFFECTS FILE < filename>. 


After the comparison phase, the files on which one or more comparison errors have been detected are 
copied sector by sector onto the output device (this is the copy phase). If these files were IN USE 
during the dump phase, the operation will only be performed if they are no longer IN USE during 
the copy phase. 


If an input error occurs, retries are attempted and warning messages are displayed (see next paragraph). 
If these retries fail, the input sector is bad and the output sector is filled with the error pattern ‘‘BAD- 
BAD...”’ 
Recoverable Input Errors 
When an input error occurs, retries are attempted until one of them is successful or until the maximum 
number of retries allowed is reached. The maximum number is 24, unless otherwise specified in the 
initiating message. 
If the input operation is successful after the retry, the following message is displayed: 

< MIX/DISKDUMP > : ERROR OVERCOME ON “ < mifid/fid > ” ... 

.. (SECTOR < nnnn> ) AFTER < nn > RETRY(IES). 
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If the input operation fails, the input sector is bad and is treated as such (see Bad Sectors Errors). 


Error logging, as mentioned in the next paragraph, is logging internal to the DISKDUMP program. 
Entries for errors are made in two data segments, allowing 3000 COMPARISON and 3000 INPUT 
and OUTPUT errors to be recorded. Additional errors are not logged. 


Bad Sectors Errors 


1. Bad Sectors 
. oaa o 


+t: 
wee 


If a sector cannot be read from the input device, even after the number of retries allowed, the corre- 
sponding sector on the output device is filled with the error pattern ‘‘BADBAD...’’. An INPUT errer 
is logged. If the bad sector can be read during the comparison phase, a COMPARISON error is also 
logged. 


2. Bad Sectors On The Output Device 


If a sector of the output disk cannot be written into, it is skipped and the corresponding sector from 
the input device is not copied. An OUTPUT error is logged. 


If the corresponding sector from the input device was filled with the “‘BADBAD...”’ pattern, no COM- 
PARISON error is logged. Otherwise, a COMPARISON error is logged for this sector. 


INPUT and OUTPUT Error Messages 


INPUT or OUTPUT error 


fegaz 
Ye fae ee = Do A oman Y id 


<mix/DISKDUMP. : INPUT (OUTPUT) ERROR on <pid> AT SECTOR <xxxx> ... 
... AFFECTS FILE <filename> 


Fatal Errors 


If a communicate error occurs while copying the first 32 sectors, or during the error location phase 
in the COMPARE, the execution aborts with the following message: 


< Mix/DISKDUMP > PERMANENT I/O ERROR WHILE IN READ FROM ... 
... ( WRITE TO ) “* < mfid/fid > ’? — EXECUTION ABORTS. 


< MIX/DISKDUMP > UNEXPECTED FCM [fcm] RECEIVED FOR ... 
. “ < mfid/fid > ’? — EXECUTION ABORTS. 


Program Warnings 


1. If the input disk is a system disk, it is opened via the ‘““SYSMEM LOCK’”’ facility, and if files 
were left open on this device, the following warning message is issued: 


< Mix/DISKDUMP > *** WARNING *** <nnn> FILES WERE OPEN ON ... 
. < pid > WHEN DUMP BEGAN. 


The program scans the DFHs of the input disk and displays the file names that are in use. The 
temporary files are referred to as (TEMPORARY <Mix #> <file #> ). Temporary files and 
files in use are not dumped. 


2. If an unlabelled open is performed on the input (output) disk, and if it is a CMS disk, DISK- 
DUMP compares the label pack-id with the pack-id from the initiating message. If they do not 
match, the following warning is issued: 
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< Mix/DISKDUMP > *** WARNING *** INPUT (OUTPUT) DEVICE IS 
<label pack-id> ... ~ NOT <specified pack-id>. 
DO YOU WANT TO RESUME PROCESS ? <YES or NO> 


The utility waits for an answer given via an ACCEPT. 

If the answer is NO, DISKDUMP goes to End Of Job. 

If the answer is YES, the process continues and the pack-id is the one specified in the initiating 
message ( <specified pack-id> ). 


3. If an open or a close (other than unlabelled disk open) fails, the following message is displayed: 


< Mix/DISKDUMP > [ event) CANNOT OPEN/CLOSE ‘‘ < mfid/fid > ”’ ... 
... ( device — reel nb. ) 


End Of Job Messages 


< mix/prog > : < xxxxxx > RECORDS DUMPED ( case of DSKMTP) 
COPIED ( case of DSKDSK) 
LOADED ( case of MTPDSK). 


< mix/prog > : < xx > ERROR(S) DETECTED ON INPUT DEVICE .... 
.... < mfid/fid > ( device ) 


< mix/prog > : < yy > ERROR(S) DETECTED ON OUTPUT DEVICE ... 
. < mfid/fid > ( device ) 


Warnings 


When the copy phase is complete, and if a disk has been open ‘‘unlabelled’’, DISKDUMP performs 
an AVR on that disk. Therefore, the activity is stopped during this time. 


Copying a disk where files are actually used in output obviously produces comparison errors at COM- 
PARE time. 


Approximate Duration of the Process 


DSKDSK of a 206 disk pack to a 206 disk pack: 8 min. 
A comparison : 11 min. 


DSKDSK of a 207 disk pack to a 207 disk pack :30 min. 
A comparison : 45 min. 


DSKMTP of a 206 disk pack to two 2400 feet tapes : 8 min. 
A comparison : 10 min. 


DSKMTP of a 207 disk pack to seven 2400 feet tapes : 30 min. 
A comparison : 35 min. 


10-20 


LT (Load Line Printer Train) 


This utility allows the proper chain of characters to be loaded on a 450/750 LPM printer. After 
CLEARSTART, the first time a 450/750 LPM printer is switched on-line, the message: 


“LT REQUIRED FOR LP<x>”’ 
is displayed, where <x> is the printer mnemonic. The operator has then to enter: 
“LT LP<x> <chain type>”’ 


where <x> is the printer mnemonic and <chain type> must be one of the following train names 
or train numbers: 


For 1100/1500 Train Printers: 


Train Name Train Description 
Number 

EBCDIC18 001 18-character EBCDIC 
FORTRAN48.NONSTD 002 48-character FORTRAN.NON STD 
B300.B50048 003 48-character B300/B500 
EBCDIC48 004 48-character EBCDIC 
ERCDIC72 005 72-character ERCDIC 
UKB3500.72 006 72-character EBCDIC 
UKB6500.72 007 72-character EBCDIC 
PORTUGAL.72 008 72-character EBCDIC 
SPAIN.72 009 72-character EBCDIC 
FINLAND.72 010 72-character EBCDIC 
DENMARK.72 011 72-character EBCDIC 
BCL72 012 72-character BCL 
TURKEY.72 013 72-character EBCDIC 
SWEDEN.72 014 72-character EBCDIC 
ASCII72 015 72-character ASCII 
EBCDIC96 016 96-character EBCDIC 
EBCDIC-UPPER.CASE 016 96-character EBCDIC 
EBCDIC.UPPER.CASEB 016 96-character EBCDIC 
EBCDIC-LOWER.CASE 016 96-character EBCDIC 
EBCDIC.LOWER.CASEB 016 96-character EBCDIC 
KATAKANA 017 96-character KATAKANA 
EBCDIC.A72 018 72-character alphatbetized EBCDIC 
EBCDIC.N72 019 72-character numericized EBCDIC 
RPG48 020 48-character RPG 
OCR.A72 021 72-character OCR-A 
OCR.B72 022 72-character OCR-B 
FORTRAN48 036 48-character FORTRAN 
THAI 052 144-character THAI 


For 400/750 LPM Train Printers (PRINTER CONTROL 5 or 6): 
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Train Name . Train Description 


Number 
FORTRAN48 130 48-character FORTRAN 
FORTRAN48.NONSTD 130 48-character FORTRAN.NON STD 
B300/B500.48 131 48-character B300/B500 
EBCDIC3.48 132 48-character EBCDIC-3 
RPG48 140 48-character RPG 
EBCDIC96 144 96-character EBCDIC 
KATAKANA 145 96-character KATAKANA 
EBCDIC3.16 254 16-character EBCDIC-3 
EBCDIC3.64 255 64-character EBCDIC-3 


Output Messages 
The normal End Of Job message is: 


“<train name> = <train number> LOADED ON LP<x>” 


Error Messages 

If an error is detected, in some cases a message will be displayed to indicate the problem, in other 

cases the program will terminate with the message: 
<error number> ** LT ABORTS ** 


The following gives the error numbers and their meanings: 


Error Message And Description 
Number 


01 “LP <x> NOT AVAILABLE FOR LT” 
Printer file could not be opened for a reason other than device not on system, printer 
in use, or “‘NO FILE”’ condition. The reason for the failure is unknown but is not a 
recognized CMS condition. 


02 No buffer is available for LT. 
03 Problem reported when loading translate table to printer. 
04 Conditional failure when closing line printer. 
05 Access failure on SYSTRANSLATE. 
06 System type is not B 1000 CMS system. 
07, 08 SYSTRANSLATE open failure other than ‘‘NO FILE’’, disk locked or file in use. 
09 Conditional error on READ of SYSTRANSLATE. 


Teach Option 
“LT T’’ command causes the SPO to display: 


1. The syntax diagram of the LT utility. 
2. A list of the train names with their train number. 
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MEM.ANALYZER 


A memory dump file can be obtained by executing the appropriate MEM.DUMP cassette in stand- 
alone mode (for operating instructions, refer to MEMORY.DUMP in Stand-Alone Utilities later in this 
section). This causes the contents of the memory to be written into a file named DMFILOO. 


If this file exists when a memory dump is initiated, the memory dump will use file DMFILO0001, 


RATT AANRDA 


will overwrite the contents of DMFILOO. 


The file DMFILO0 is created on the system disk. If enough space is not available on that disk, or if 
memory is corrupted so that the location of that disk is destroyed, the program halts to enable the 
operator to direct the dump to another disk. 


The system must then be restarted, with a CLEARSTART, and the MEM.ANALYZER program must 
be executed to obtain a formatted, analyzed listing of the memory dump file. 


IMPORTANT 
If a DCP dump is also required following CLEARSTART, (always the case 
on a B 1990), ONLY the START button must be pressed and NOT the 
CLEAR button. On a B 1990 use TAPE GO and not MTR GO. 


The listing can be obtained by invoking MEM.ANALYZER with the following syntax: 


MEM.ANALYZER <pack-id > / <file-id > 
FULL 


ALPHA 

HEXA 

SELECTION 
PATCH 

NO.SCL 

NO.DCOM 
DCOM.ONLY 
MIX.ONLY <x>- 


FROM < address > 
TO < address > 


<pack-id > indicates the name of the device containing the dump file to be analyzed. 
< file-id> indicates the name of the dump file to be analyzed. 
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The options, entered in any order, have the following effects: 


FULL 

ALPHA 

HEXA 

PATCH 

NO.SCL 
NO.DCOM 
DCOM.ONLY 
MIX.ONLY <x> 


FROM <address> 
TO <address> 


SELECTION 
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Print tables and all memory in hexadecimal. 

Print memory contents in alphanumeric. 

Print memory contents in hexadecimal. 

Printing of the patch analysis is enabled. 

Disable SCL partition decoding. 

Disable Data Comm module decoding. 

Disable User-memory analysis. 

In analysis of User-memory, only the mix specified by <x> _ will be 
considered. 

When ALPHA or HEXA is used (default is 0). 

When ALPHA or HEXA is used (default is the maximum memory value). 
1. The FROM and TO options do not require the specification of ALPHA 
or HEXA. The default is HEXA. 

2. The FROM...TO.. option cannot be repeated to print different portions 
of memory in one run. 


This option causes a series of ACCEPT/DISPLAY’s to be executed on the 
SPO. These allow the operator to select sections of the dump listing to be 
printed on a printer. 

The syntax for these sections follows: 


MAT indicates the Memory Assignment Table portion of 


the listing. 


VM indicates the Virtual Memory Tables and VM 
statistics portion of the listing. 


PHYSIO indicates the PHYSICAL.IO information portion, 
that is, Channel Control Words, Device Control 
Blocks, Channel Control Blocks, etc. 

DCOM indicates Data Comm information. 

SCL indicates SCL information. 


SEGMENT <integer- 
1> <integer-2> 


indicates a data segment to be printed. 


<integer-1> is the data segment number in the 
Data Segment Table. 

<integer-2> is the Mix number of the associated 
program. 


FIB <integer-1> indicates the FIB to be printed. 

<integer-2 > 
<integer-1> is the data segment number of the 
segment containing the FIB in the Data Segment 
Table. 
<integer-2> is the Mix number of the associated 


program. 


The entire User Memory Analysis section (that is, 
ICB, DST, PST, File information) for the Mix 
indicated by <integer>. 

indicates the ICB of the Mix indicated by 
<integer >. 


MIX <integer> 


ICB <integer> 


DST <integer> indicates the Data Segment Table of the Mix 
indicated by <integer>. 


PARTITION indicates a hexadecimal dump of the partition of 
< integer > the mix indicated by <integer>. 
PART LAYOUT indicates the layout of segments in memory for the 
<mix num> specified mix. 
PROG SEGMENT prints the content (in hex) of the specified program 
<seg num> segment of this mix. 
<mix num> 
END terminates the selection process. 
NOTE 


The printer file used in this selection process cannot be diverted to backup. 
For a selective listing which can be diverted to backup, use the other ME- 
M.ANALYZER options. 


NOTE 
Each dump submitted with an FTR must use the default option. 


This program analyzes the input file specified and a complete listing gives: 


A form to be filled in by the user. 

A form to be filled in by the Burroughs representative. 

— The contents of the main registers (some registers must be noted manually — see 
MEMORYDUMP later in this section). 

— The last 12 entries in the Address Stack. 

— Scratchpads. 

— Hints. 

— Mix table. 

- Monitor stack analysis. 

— Memory assignment table. 

— Dual processor table. 

— Virtual memory tables. 

— Virtual Memory statistics. 

— Channel and Channel Control Word tables. 

— Channel control blocks. 

— Device control blocks. 

— File control blocks. 

— SCL partition (mix # 0). 

— Overlay module analysis (mix #62). 

— DATA COMM module analysis, if DCCH was running. 

— Shared files Data segment. 

— A few other system tables. 

— For each user mix, its ICB, PST, DST, FIBs and FPBs. 


The copy of the interpreters in memory is compared with their initial version on the system disk and 
the address of the first discrepancy, if applicable, is displayed. 


The Memory Dump file is always retained after MEM.ANALYZER has gone to End of Job. It can 
be removed with the RM command by the operator. 
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The default option does not analyze everything in the memory dump file. It is therefore recommended 
that the file be copied to a backup disk, or dumped to a tape, in case the information not in the 
analyzed listing is requested later. 
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NPC1.B1000 
Introduction 
The NDL Post Compilers are MPL programs which take an NDL S-code file as input and generate 


one or more DCP microcode files. These files are loaded in the appropriate DCP at Data Comm Sub- 
System (DCSS) initialization time. 


Since three Data Comm processors exist (DCP-1, DCP-3 and DCP-4), the correct NDL Post Compiler 
must be used to generate the appropriate DCP code files. 


The NPC1.B1000 generates code files to be loaded on DCP-1. 


Any mismatch is recognized by DCCH, which issues an error message and terminates the loading of 
that DCP. 


Use of the NPC1.B1000 
NPC1.B1000 should be run after each successful NDL compilation. 
Syntax 


NPC1.B 1000 aa ——— FILE _s< ofid/fid > LIST 


It is strongly recommended that the CODEFILE statement is used in NDL to give a distinctive name 
to the NDL S-code file. 


The LIST option produces a listing of the microcode file(s) produced by NPC1.B1000. 


The names of the microcode files produced are taken from the TERMINAL statements in the DCP 
section of the NDL source. 


As each microcode file is created, the message: 

<mix>/NPC1.B1000 MICRO CODE FILE <file-id> CREATED 
is displayed. 
If a file exists with the same name as the DCP file, a “‘DUPLICATE FILE”’ message is issued by 
the MCP. The RM function must be used to remove the old file. (DCP files are ““SSYSTEM”’ files 
so their removal must be ‘‘OK’ed’’). 


If the file is not an NDL S-code file, then NPC1.B1000 displays: 


NO NDL OBJECT FILE 
ENTER NEW NDL OBJECT FILE NAME (NULL ACCEPT TO USE SAME FILE) 
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Introduction 

See Introduction for NPC1.B1000. 

The NPC34.B1000 generates code files to be loaded on DCP-3 or DCP-4. 
Use of the NPC34.B1000 

The NPC34.B1000 should be run after each successful NDL compilation. 
Syntax 


NPC34.B 1000 aa LE << fi ‘fi > LIST 


The LIST option creates a printer backup file named PBO0000, containing a listing of the microcode 
bd 


—) 


See NPC1.B1000 for the names of the microcode files and for the utility messages. 
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PATCH.MAKER 


This utility is released in order to implement required patches to released firmware. This utility either 
reads a file of patches from cassette or generates such a file from SPO input. 


It is recommended that an adequate backup system is employed. 


The easiest way to patch the MCP is to use two System disks. However, a single System disk can be 
used to perform the patching of the BIL interpreter (BILINTERP), the COBOL interpreter (COBO- 
LINT), the DCP-3 or the DCP-4 NDL Post Compiler (NPC34.B1000) as well as of the MCP when 
two System disks are not available (see Operating Instructions later in this section). 


Remember that ALL disks containing system software should be updated with the patched software. 


Levels of patches are successive. If a user requires patch level 3, for example, then both previously 
released patches must have been implemented. The utility employs a number of checksum routines 
which prevent patching of the wrong file and implementation of unauthorized patches. 


The utility first asks the user, with displays and accepts, for the identity of the firmware file to be 
patched in this run (MCP, BILINTERP, COBOLINT or NPC34.B1000) and of the new file to be cre- 
ated. 


The user is then asked to specify if the patches are to be entered via the SPO or via a cassette. If 


the response specifies cassette, a search for a tape file named ‘‘PATCHES” is initiated. When this 
file is found, the patching is carried out. If the response specifies SPO, the patches are to be entered 
via the keyboard from the hard-copy supplied. The characters entered must be exactly as supplied. The 
series of characters can be divided into several series of any length up to 254 characters. The operation 
is terminated by a null AX. 


In order to minimize the risks involved in transmitting patches by TELEX, and possible errors in oper- 
ator action, an initial sumcheck has been inserted in the patch string itself. Each 12 bytes of patch 


information are sumchecked. If a mismatch is detected, the wrong 12-byte group will be displayed and 
these 12 bytes must be re-entered via the SPO. 


A null ‘‘AX’’ terminates input and allows the patching to begin. 


If any message is displayed, one of the checks has failed. The input must be examined and re-entered 
when the error is found. 


Error Messages Displayed 
<string of 24 bits> AT OFFSET <nn> IS INVALID: RESUBMIT ON SPO 

Initial sumcheck has detected an error within the string of digits entered via the SPO or cassette. 
PATCH LEVEL DISCREPANCY 


The specified file does not have the patch level expected. All previous patches must have been en- 
tered. 


INITIAL SUMCHECK DISCREPANCY 


The sumcheck of the original file to be patched does not match the value contained in the patch 
entry. All previous patches must have been entered. 
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FINAL SUMCHECK DISCREPANCY 


The sumcheck of the patched file does not match the value contained in the patch entry. Try again 
on another disk drive. If the error persists, the patch may be in error. Contact your local 
Burroughs representative. 


ADDRESS ERROR 


The address given for a micro is out of range for the file specified. Try again on another disk 
drive. If the error persists, the patch may be in error. Contact your local Burroughs representative. 


OLD/NEW MICRO DISCREPANCY 


The old micro contained in the patch entry does not match the old micro in the file to be patched. 
All previous patches must have been entered. 


Example 
Assume that a pack with all the released software is available. It is called BKP3.04. 


The system is CLEARSTARTed with BKP3.04 as system disk. The patch consists of a hard-copy (flash 
with ‘*333355554444’’, for example). 


When CLEARSTART has finished: 


PATCH.MAKER 
02/PATCH.MAKER BOJ PR=A TIME: hh.mm.ss 
02/PATCH.MAKER [DISP] ENTER NAME OF FILE TO BE PATCHED 
02/PATCH.MAKER [DISP] [<PACK-ID>/] <FILE-ID> 
02/PATCH.MAKER [ACPT] 

AX 02 BKP3.04/MCP 
02/PATCH.MAKER [DISP] ENTER NAME OF NEW FILE 
02/PATCH.MAKER [DISP] [<PACK-ID>/] <FILE-ID> 
02/PATCH.MAKER [ACPT] 

AX 02 BKP3.04/MCP001 
02/PATCH.MAKER [DISP] ENTER INPUT DEVICE: SPO OR CASSETTE 
02/PATCH.MAKER [ACPT] 

AX 02 SPO 
02/PATCH.MAKER [ACPT] 

AX 02 33335555 
02/PATCH.MAKER [ACPT] 

AX 02 4444 
02/PATCH.MAKER [ACPT] 

AX 02 
02/PATCH.MAKER EOJ 


When this has finished, CLEARSTART the system with BKP3.04 as system disk, with 000001 loaded 
in X register between TAPE mode and RUN mode (see CLEARSTART later in this section). 


Operating Instructions for Patching the MCP File 
The easiest and safest way to proceed is to use two system packs. However, it is possible to work with 


one system pack only. 
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IMPORTANT 
The MCP file used must not have had a DCP dump stored in it by the SDA 
utility. To be sure of this a ‘‘virgin’’ copy of the MCP file should be kept 
and used as the input MCP file to PATCH MAKER. 


Two System Packs Are Available (SYS1 and SYS2) 


1. CLEARSTART with SYSi as System disk 
SYS2 as User disk. 
2. Run PATCH.MAKER with the file MCP on the System disk as input file 
a file MCP on the user disk as output file. 
Thus, the ‘‘name of the file to be patched’”’ is : SYSI/MCP, and 
the ‘‘name of the new file’ is : SYSZ2/MCP. 
3. CLEARSTART with SYS2 as System disk 
SYS1 as User disk. 
4. Copy MCP to SYS1/MCP. 


One System Pack Only Is Available 


1. Copy the MCP file to MCPxxx. 
2. Run PATCH.MAKER with MCPxxx as input file 
MCPyyy as output file. 
(xxx and yyy being three-digit integers) 
3. There are now two ways of using the new MCP file MCPyyy: 
A. CLEARSTART directly with MCPyyy. 
B. Copy MCPyyy to MCP and CLEARSTART. 
It is strongly advisable to use procedure A, and to avoid procedure B when possible. 
A. CLEARSTART with 000yyy loaded in the X register between TAPE mode and RUN mode 
(see CLEARSTART later in this section). 
B. 1. Copy MCPyyy to MCP 
2. Ensure that two conditions are satisfied while copying MCPyyy to MCP: 
1) A NULL MIX (even SYS-SUPERUTL must be DS’ed). 
2) NO DEVICE STATUS CHANGE (No device hardware interrupt). 
3. Set the Interrupt switch (Maintenance panel interrupt toggle). 
4, CLEARSTART. 
If any problem arises during these operations, it is always possible to re-run with the old MCP 
file by CLEARSTARTing with the file named MCPxxx. 
A COLDSTART selecting only the file MCP on the release tape is another means of loading 
a valid MCP when a patching operation has failed. 


Example 


To apply patch 45 to the MCP file, having one system disk only: 


1. Copy MCP to MCP045. 

2. Run PATCH.MAKER with 
“name of the file to be patched’’: MCP045 
“name of the new file’: MCP046 

3. Then, either 
1) Perform a CLEARSTART with 000046 loaded in X register between TAPE mode and 

RUN mode. 
or 
1) Copy MCP046 to MCP, after having DS’ed all programs in the MIX. 
2) Interrupt and CLEARSTART. 
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Operating Instructions For Patching the Interpreters or NPC34.B1000 
Ensure that the file to be patched is not in use: 


— No COBOL or RPG program running for patching COBOLINT. — No MPL program running 
for patching BILINTERP (all utilities are written in MPL). 


Example: 
To patch the BILINTERP: 
1. Copy BILINTERP to BILINTERP1. 
2. Run PATCHMAKER with BILINTERP! as input file, 


BILINTERP2 as output file. 
3. Copy BILINTERP2 to BILINTERP. 
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RETRIEVE 


This utility provides the user with a means of copying to disk one or more single files from a tape 
created by the DISKDUMP program. 


Syntax 
The following syntax diagram is displayed by entering: 


“RETRIEVE” 


DISPLAY 


DIRECTORY 
PRINTER 
RETRIEVE meme 9 < tape-id > 


< file-id > 
TO <pack id > 


DIRECTORY Gives to the user the list of the files which are present on the tape, 
directed to the device specified by one of the following options: 


DISPLAY causes a single list to be displayed on the screen. 


PRINTER provides the user with detailed information about each file 
residing on the tape, that is, 

the pack-id (of the originating disk), 

the file-name, 

the actual and the maximum file size, 

the creation date and the last access date, 

the file type. 


TO <Pack-id> Gives the identification of the pack to which the files are to be loaded. 
The default is the system disk. 
< file-id> Up to 20 files can be loaded in a single run of RETRIEVE utility. 


The file names are separated by a blank, or a comma or a semi-colon 
surrounded by blanks. 


Messages 


Most of the messages that are displayed are self explanatory. The following ones need some explana- 
tion. 


If a file to be loaded is already on disk, the messages: 
FILE <filename> IS ALREADY PRESENT ON DISK 


PLEASE REMOVE IT AND ANSWER TO THE ACCEPT 
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are displayed on the screen. 


The utility resumes as soon as an answer has been given to the Accept, whatever this answer might 
be (a blank or any word). 
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SDA (Oniy Reievant To B 1990 Systems) 


This utility provides the user with the means of transferring SPO DCP dump information from a re- 
served area of the MCP to a file which is accessible by the DCP ANALYZER utility. 


if the SPO DUMP option in SYSCONFIG is SET, the SPO DCP memory is stored in the MCP file 
isk at CLEARSTART. This avoids the problems of no disk space or directory full. 


The initiating message for the program is ‘“SDA”’’. 


The program creates a dump file which has an identifier of the following format: 


eeese 


where jjjjj = julian date and nn = dump number. 
Completion Message 


After the dump has been created successfully, the following message is displayed: 


The program now zips DCP.ANALYZER to provide an analyzed listing of the SPO DCP dump. 
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STAND-ALONE UTILITIES 


The stand-alone utilities perform specific functions which are not under MCP control. The following 
are the stand-alone utilities available with this release: 


Name Function 
COLD.START Loads system software to disk from a CMS library magnetic tape. 


CLEAR.START Determines the system configuration, builds tables and places the system 
under MCP control. 


PACK. INIT Initializes a disk pack in CMS format. 
MEMORY.DUMP _ Creates a disk file (DMFIL00) containing a complete image of the system 
memory. 


All these stand-alone utilities are initiated with cassettes. 


Creation Of Cassettes 


The COPY utility has the facility to enable B 1000 series stand-alone cassettes to be generated under 
CMS MCP coniroi. Creating cassettes requires an I/O cassette drive on the system. The inbuilt cassette drive 
cannot be used, because it is used only for loading the stand-alone utilities. 


Syntax 


COPY <sau-file-name> TO XXX MTP NO.LABEL 
where <sau-file-name> is one of: 


CLEAR.START PACK.INIT 
COLD.START MEMORY.DUMP 


Operating Instructions 


1. Place blank cassette in CTA. 
2. Enter ‘““PG CTA’’. 
3. System displays: ‘“CTA PURGED’’. 
4. Enter COPY message. 
5. System displays: 
““<mix>/COPY WAITING SPURIOUS/XXKX AT NO FILE’’ 
. Enter ‘AD <mix> CTA’’. 
. Cassette is created and the following message displayed: 
**<sau-file-name> TO XXX COPIED’’ 
. To write on the other end of the cassette, remove it from the drive, wind on by hand until 
tape is exposed in the opening and insert it the other way round in the cassette drive. Go back 
to step 2. 


“TN 
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Initiation of the Stand-Alone Utilities 
For All Systems Except B 1825/30, B 1990 


1. Place the cassette in the cassette reader on the control panel. Rewind if necessary so that the 
BOT light is illuminated. 

2. Set the register select switch so that it points to the L register. Set the cassette switch to SYS- 
TEM, if applicable. Ensure that the SINGLE MIC/CONT switch is set to CONT and MICRO 
SELECT to NORMAL (B 1860), or SINGLE MICRO to NORMAL (B 1900). 
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eS 
3. Set the MODE switch to the MTR position. Press the CLEAR and then the START buttons. 

If the cassette does not start, press HALT and CLEAR simultaneously and then START. After 
reading the cassette, the system will halt with @AAAAAA@ in the L register and the release 


level (for example, 03.04.00) in the T register. 
4. Set the MODE switch to the NORMAL position and press the START button. This will load 


the program and begin execution. 


B 1825/30 System 


Place the cassette in the cassette reader. If the cassette is not at BOT, it automatically rewinds. 


. Enter ‘‘ST”’’. 
. Press the CLEAR and START buttons. 
. Enter ““CR23”’ (this is the L register). ‘0101 0101 0101 0101 0101 010i AAAAAA”? is dis- 


played. 
5. Enter ‘“‘SR’”’ and press the START button. The program will load and begin execution. 


B 1990 System 


1. Place the cassette in the cassette reader. If the cassette is not at BOT, it automatically rewinds. 
2. Ensure the system is halted, one of the maintenance screens is displayed and the terminal 


“FORMS”? light is on. 
3. Enter “MTR GO” to begin the CLEAR and START functions or ‘““TAPE GO”’ to begin the 


START function. 


kwWN 


All Systems 
NOTE 
The CLEAR function causes the contents of the DCP memories to be reset. 
If the DCP memory dumps are required following a CLEARSTART, do not 
action the CLEAR function. 


The following halts are common to all stand-alone utilities: 


Contents of L Description 
@000004@ Cassette parity error. 
@111111@ No channel found with SPO attached. 
@222222@ Invalid response after a test service request. 
@333333@ Invalid status. 
@444444@ Memory parity error. 
@555555@ Invalid result descriptor. 
@666666@ SPO not ready. 


Cassette Error 


If, during the loading of a stand alone cassette, the system halts with “CASSETTE ERROR”’ displayed 
corresponding to the register PERP = 1, it indicates incompatibility between the cassette and the drive. 
This may be due to: 
1. Bad cassette 
— try other end of cassette 
— try another cassette 
— also see following note. 
2. Cassette drive heads misaligned — call Burroughs Customer Service Engineer. 
3. Bad cassette drive — call Burroughs Customer Service Engineer 
NOTE 
Although the problem is primarily due to incompatibility developing between 
cassette and drive, switching the machine off then on again may resolve the 
problem temporarily. 
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COLD.START 


COLD.START loads system software from a CMS library tape (a single reel tape) to disk (either disk 
pack or disk cartridge). 


It can be either 800 BPI NRZ or 1600 BPI PE, and any tape unit may be used. 


NOTE 
If a file on disk is found with the same name as one on the tape, the tape 
file is loaded and the disk file is removed. However, it is advisable to initial- 
ize the disk before using the COLD.START program, or to reinitialize the 
disk if COLD.START aborts. 


COLD.START is only necessary for new installations. Users of the 3.04.00 release need only initialize 
a user disk and use ‘““LD LOAD FROM <tape-id> TO <pack-id> =”? to create a new 3.05 system 
disk. 


Operation 


Before loading the cassette, ensure that the output disk drive and the input tape drive are both ready. 
This applies particularly to the B 1990 where the system will halt if the device is not ready, resulting 
in the MTR screen being displayed. If the device is then made ready and GO entered to restart the 
system, the utility output messages will appear on page 1. Ensuring that devices are ready before start- 
ing avoids the spread of messages over page 1 and page 2. 


““**** B1800/B1900 CMS COLDSTART **** MARK 3.05.01’ is displayed and the cartridge/pack 
configuration is displayed. 


Disk Pack and Cartridge Units 
CHANNEL x Dyy Dyy ... 


The value x of the channel is given in hexadecimal (2, B,...). The different values of yy correspond 
to the identification of all the units connected to disk controls (DKA, DPB,...) 


Parameters have to be entered by the operator, in answer to the following questions: 
QUESTION: CMS DISK DRIVE —~<DPX> OR <DKX> 


RESPONSE: Enter disk drive on which the system software is to be loaded, for example ‘‘DPA”’. 
Any bad specification causes the program to ask for the same information again. 


The magnetic tape configuration is then displayed. 
Magnetic Tape Units 
CHANNEL x MTy MTY ... 


The value x of the channel is given in hexadecimal (2, B,...). The different values of y correspond 
to the identification of all the devices connected to magnetic tape controls (A, B,...). 


QUESTION: CMS MAG TAPE UNIT - <MTX> 
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RESPONSE: Enter the mnemonic for the tape unit on which the CMS library tape is loaded. 
Any bad specification causes the program to ask for the same information again. 


The tape label is read and the following messages are displayed: 
“CREATION DATE OF TAPE: MM/DD/YY”’ 
QUESTION : DISPLAY LOADED FILES ? <YES OR NO>. 
RESPONSE: Enter “‘YES’’ if a list of all files loaded is required, ‘‘NO’’ if no list is required. 
The following information is then displayed: 
“RELEASE LEVEL : N” 
where: 
N = 3 if the tape was created with a 3.02 version (or any previous version) of LD. 
N = 4 if the tape was created with a 3.03 or later version of LD. 
This information is obtained from the label of the tape. 
QUESTION: ‘LOAD ALL FILES <YES OR NO>” 
A “YES” response directs COLDSTART to load all the files from the tape. 
A “NO” response causes a display of the following message: 
‘ENTER FILE NAME <12 CHAR OR ETX>” 
The operator must enter the name of the file or the family of files (a character string appended with 


an ‘‘=’’) required. This message is displayed again until a blank entry (ETX only) is made or the limit 
of 20 entries has been reached. 


NOTE 
Introducing a file name or a family name with no entry in the directory of 
the tape will display the error message: 


“THIS FILE IS NOT ON TAPE”’ 


The operator is asked to enter another file name or family name. 
The message: 
“LOADED FILES :”’ 


is displayed, followed (if requested) by the names of the files, five per line, loaded to disk. When all 
the requested files have been loaded, the message: 


“END OF COLDSTART”’ 


is displayed. 
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NOTE 
The message ‘“‘MISSING ETX, TRY AGAIN” is displayed in the case of 
transmission without an ETX and the user is allowed to re-enter the informa- 
tion. 


It is highly recommended to check that the displayed configuration of disk 


and magnetic tape devices corresponds to the desired configuration, to avoid 
overwriting files in error. 


Error Messages 


The following error messages may be printed. The action to take is noted except where the message 
is self-explanatory. 


“NOT LIBRARY TAPE’’ 


Attempt to COLDSTART with an incompatible tape. Check that the tape unit was specified cor- 
rectly and that the tape is a CMS library tape. 


“MAG TAPE NOT READY. CORRECT AND START”. 
“DISK NOT READY. CORRECT AND START”. 


Problem with the indicated device. When corrected, on B 1800/B 1900 systems press the START 
button on the console panel, on B 1990 systems, enter ‘‘GO’’. 


“PROBLEM WITH MAG TAPE COLDSTART ABORTS” 
“DATA ERROR ON READING TAPE LABEL COLDSTART ABORTS” 


Problem encountered while reading the tape. Verify its density and try on another device if possi- 
ble. 


“PROBLEM WITH Dxx COLDSTART ABORTS”’ (where Dxx is pack or cartridge mnemonic) 
“DIRECTORY FULL COLDSTART ABORTS” 

‘“‘NOT ENOUGH SPACE ON CMS DISK COLDSTART ABORTS” 

“NOT A CMS DISK COLDSTART ABORTS’”’ 


These errors are fatal to COLDSTART and it will terminate. For the DIRECTORY FULL or NOT 
ENOUGH SPACE errors, if the minimum files for system operation have been loaded, the system 
may be CLEARSTARTed and the files on disk reorganized under MCP control. The minimum 
files for system operation are: 

MCP SYSLANGUAGE 

SYSCONFIG BILINTERP 

SYS-SUPERUTL TL 

For the ‘PROBLEM WITH Dxx” and ‘‘NOT A CMS DISK”’ errors, the disk should be re- 
initialized (on this system or reformatted under MCP contro! on another system) before attempting 


to COLDSTART again. 
“CANNOT REMOVE <FILE-NAME> PART OF DUAL PACK FILE” 


COLDSTART continues with loading the other files. Only this file is not loaded. 


“DISK NOT FOUND” 
“MAG TAPE NOT FOUND”’ 


Warning message displayed when a unit outside the controller’s range has been specified. 
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“NOT STANDARD LABEL” 
Warning message. COLDSTART will try to resume processing as if the tape had a standard label. 
“TAPE NO LONGER READY COLDSTART ABORTS”’ 


‘NOT A DISK FILE HEADER COLDSTART ABORTS” 
“TAPE MARK NOT FOUND COLDSTART ABORTS” 


Internal messages indicating that COLDSTART is lost somewhere within a file. This can be caused 
by a hardware problem on the magnetic tape device or a corrupted copy of the System tape. 


‘““COLDSTART INTERRUPTED” (flashing) 


The interrupt switch has been set during the load process. 
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CLEAR.START 
Function 


CLEAR.START determines the exact configuration of the system, builds various tables for the MCP, 
initializes memory links, executes the AVR of the system disk, loads MCP and finally, passes control 
to the Operating System. 


Selection of the MCP File 


At CLEARSTART time, the user has the ability to specify the MCP file he wants to start with. This 
MCP file must have the name MCPnnn, where nnn is a three-digit integer. 


For all systems except B 1990 the procedure is as follows: 
1. With the MODE switch set to MTR, press the CLEAR and the START buttons. 


2. Load 000Oxxx in the X register: 
1) Set the register select switch so that it points to the X register. 
2) Set the maintenance panel toggles to 000xxx (for example, to start with MCP123, set the 


Ate 


panel toggles so that they represent the binary number: @0000000000000001 00100011 @) 
3) Press the LOAD button. 


3. Set the MODE switch to NORMAL and press the START button. 
For B 1990 systems the procedure is as follows: 


1. Enter ‘TEXT MCPxxx’’ 
2. Enter ‘‘MTR GO” or ‘“‘TAPE GO”’ 


Channel Selection 


The channels to be handled by the MCP can also be selected at CLEARSTART time via the mainte- 
nance panel toggles which must be set before RUN mode, using the CSW register on B 1800 systems, 
referred to as the CNS register on B 1900 systems. 


The toggles are represented here from left to right by six one digit values (A, B, C, D, E and F); 
the first two digits (A and B) must be set to the value @FA@ and the last four digits (C to F) must 
be set to a value representing, from right to left, the numbers of the channels which have to be taken 
into consideration. 


For example, setting the toggles to @FA0203@ corresponds to the binary setting 
@111110100000001000000011@. This enables the MCP to handle only channels 0, 1 and 9. All the 
other channels are disregarded. 

On B 1990 systems set the CNS register to the appropriate @FAxxxx@ value. 

Channel Identification 


The system configuration can be interrogated using the maintenance panel at CLEARSTART time: if 
the system disk is not ready or off-line, the system halts with L=@C00009@. At this point, 


1. Load @000000@ in the L register. 
2. Press START (enter GO on B 1990). The L register contains information about channel 0. 
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i nF SS 


again. 
Format of the L Register 


LA = @0@ 


LB = channel number 


LC, LD = CMS device kind 
LE, LF = Hardware identification 
Hardware ID CMS ID Device Type 

@01@ @CF@ DSC-2 
@\E@ @CF@ DISK PACK 
@1A@ @CB@ DCC-1 
@1C@ @CB@ DCC-2 
@08@ @73@ ICMD 
@30@ @A7@ MT(NRZ) 
@34@ @97@ MT(PE) 
@3C@ @AB@ CASSETTE 
@09@ @AT@ MTC-6 
@2C@ @33@ TTY SPO 
@2E@ @33@ CRT SPO 
@10@ @0A@ PC-2-3-4 
@3E@ @0A@ PC-5-6 
@3@ @0A@ PC-7 
@0B@ @0A@ GEM-PC 
@2A@ @15@ READER-80 
@26@ @19@ READER-96 
@04@ @16@ PUNCH-80 
@06@ @1A@ PUNCH-96 
@02@ . @17@ . MFCU-80 
@0A@ @1B@ MFCU-96 
@5E@ @51@ DCP-1 
@41@ @53@ DCP-3 
@42@ @54@ DCP-4 
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DISK INITIALIZER (Pack.init) 
General Information _ 
All disks must be initialized in CMS format before they can be used under MCP control. 


The initializer performs several passes on the disk to initialize and verify it. The number and type of 
passes depends on the disk type. 


If a sector fails, it is relocated or removed if relocation is not possible. That is, an available table 
entry is made which indicates that the corresponding allocation unit is not available. At most, five sec- 
tors per track can be relocated. 


Known marginal sector numbers can be entered at the start of the initialize. These sectors are then 
relocated or removed during the initialize. (See ‘““Maximum Number of Removed Sectors’’ later in this 
section.) The disk label and disk directory are built after initialization. 

Operating Instructions 

Cassette Loading 


On cassettes the utility does not stop with L = AAAAAA as other cassette utilities do, but continues 
loading until approximately half the cassette has been spooled. 


After the cassette has been loaded, a title is displayed: 

CMS DISK PACK INITIALIZER MARK 3.05.01 (<compile date>) 
If the terminal is configured to display “ETX’’, the following message is displayed: 

PLEASE PUSH SPECIFY IF YOU SEE ETX DISPLAYED ON THIS SCREEN 
This is needed to allow the initializer to format its output correctly. If the initializer is running on 
a B 1990 and the terminal has ETX displayed, all input should be terminated with an ETX before 
pressing XMT. Alternatively, the terminal firmware may be reprogrammed so the ETX is not dis- 
played. 
If a card controller is present, the following message appears: 


IS CARD INPUT DESIRED (YES or NO) 


If the response is NO, the initializer operates in an interactive mode (see ‘‘SPO Input’ later in this 
section). 


If the response is YES, the input parameters are read from cards, one card for each disk. 
Card Format 


Each input is in free format, separated by a space, with the parameters in this order: 


Unit mnemonic A through H 
Serial number 6 digits 

Packid Up to 7 characters 
Date MM/DD/YY 
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Maximum number of files Up to 2805 
Owner’s name Up to 14 characters. 
Marginal sector numbers As many as required — decimal numbers separated by a space. 


The last two fields are optional. All other fields are checked for validity. If an error is discovered, 
the card is rejected. 


SPO Input 


If SPO input is used, parameters are entered interactively. Each field is checked for validity as it is 
input. If it is invalid, a suitable message is displayed and the field can be re-entered. 


QUESTION: ENTER UNIT MNEMONIC DP <x> or BLANK FOR EOJ 
RESPONSE: DPA, DPB and so on or BLANK 


QUESTION: ENTER 6 DIGIT SERIAL NUMBER 
RESPONSE: 6 digit serial number 


QUESTION: ENTER PACKID PR. 
RESPONSE:  packid, up to 7 characters from the set ‘‘A’”’ through ‘‘Z’’, ‘‘0’’ through “‘9”’ or 


QUESTION: ENTER DATE AS MM/DD/YY 
RESPONSE: date as MM/DD/YY 
QUESTION: ENTER MAXIMUM NUMBER OF FILES (UP TO 2805) zy¢ 5 
RESPONSE: A decimal number between 1 and 2805 
NOTE 
See Available Table Size Example later in this section. 
QUESTION: ENTER OWNER’S NAME TBC 
RESPONSE: up to 14 characters (this is optional — a single blank is acceptable). 
If a printer is available, the operator is asked 


QUESTION: DO YOU WANT A PRINTOUT OF REMOVED SECTORS? (LPx or NO) 
RESPONSE: LPA, LPB and so on, or NO 


Finally: 
QUESTION: ENTER MARGINAL SECTORS (DECIMAL SECTOR NUMBERS) 
RESPONSE: Decimal sector numbers of known marginal sectors. 


Up to three lines of numbers may be input at a time. The order of sector numbers input is not impor- 
tant; the numbers must be separated by at least one space. 


If a printout has been requested, a heading is printed. 
The disk will now be initialized. While initialization is in progress, pressing the XMT button displays 
information about the initialize. The initializer processes each cylinder completely before starting the 


next cylinder. 


If a printout of removed sectors is requested, a list of sector numbers removed from a cylinder is 
printed when that cylinder has been completely processed. 
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If the printer becomes not ready, the initializer is suspended when it tries to write the printout and 
remains suspended until the printer is ready. The following message is displayed: 


DISPATCH TO PRINTER LPx FAILED — SUSPENDED UNTIL PRINTER READY 


When the initialize is complete, a message is displayed on the screen indicating the number of bad sec- 
tors. The message is in the form: 


DPx : ID = <packid>, SER # <serial number> 

<error count> BAD SECTORS (<relocate count> RELOCATED <remove count> RE- 
MOVED) 

INITIALIZATION COMPLETED 


A similar message is printed if the printer option was selected. 


The initializer then displays the original prompt. This allows another pack to be initialized or, if a 
blank is entered, allows the initializer to be sent to End Of Job (EOJ). 


Time Needed 


The time taken to initialize packs depends on the type of pack and the number of sectors that need 
to be relocated or removed. Times for various packs with around 20 bad sectors are approximately: 


25 minutes for a 205 
35 minutes for a 206 
150 minutes for a 207 
60 minutes for a 225 
For a 207 with 2000 bad sectors, the time will be around 190 minutes. 
Error Messages 
All error messages are self explanatory and most are related to the detection of bad syntax. 


If the error is not related to bad syntax, the following values are used when no message can be dis- 
played: : 


Halt Value (T Register) Meaning 
FCO000 No local SPO found. 
FCID <port and channel> Dispatch to local SPO failed (B 1800/B 1900) 
FCIE <port and channel> SPO error 
FC20 <port and channel> Dispatch to local SPO failed (B1990) 


Available Table Size — Example 
The size of the Available Table is given by the following algorithm 
(number of files requested/32) + 3 
The Available Table size is extended so that the whole directory ends on an allocation unit boundary. 
Therefore, on a 206 pack where the allocation unit is 8 sectors, 2805 files will give: 


2805 sectors for headers 
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255 sectors for name list 
91 sectors for Available Table (2805/32) + 3 


3151 sectors for the whole directory. 


The Available Table is extended to 92 sectors to have a total directory length of 3152 sectors (the next 


The maximum number of removes varies with the disk type: 


223 and 225 : 2030 
205 and 206 : 4070 


207 no explicit limit : limited by available table 
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MEMORY.DUMP 


The function of the MEMORY.DUMP utility is to get the contents of the memory written into a mem- 
ory dump file, named DMFILO0 (refer to the MEM.ANALYZER utility for the listing of the dump). 
If DMFILOO0 already exists when a memory dump is initiated, the contents of the memory are written 
into file DMFIL0001, DMFIL0002 or the first free file up to DMFIL0099. If all these files are used, 
the message dump will overwrite the contents of DMFILOO. 


Operating Instructions 


The MEMORY DUMP cassette must be executed in Stand-Alone mode. If the system is still running 
at the time a memory dump is desired, it must be stopped with the INTERRUPT button. If INTER- 
RUPT does not halt the system, it is in a loop. Therefore, before taking a memory dump, the loop 
addresses should be recorded. (See ‘‘How To Trace A System Loop” later in this section.) 


When the system has been halted, the MEMORY DUMP cassette should be loaded as described in 
the following paragraphs. 


NOTE Before taking the dump, check the following: 


1. For all dumps, record the values in PERM and PERP as these are not stored in the dump file. 

2. If it is known that the dump will be re-directed to a pack other than the system pack, record 
the values of the following registers as they will be overwritten by the utility: L, T, X, Y, A, 
CC, CD, PERM, PERP, LR, FA, FB, CP, MAXS, SOA to S15A, TAS and the first ten values 
on STK. 


Loading Instructions 
1. If running on a B 1825/30, note the value of the A register and press the CLEAR button. 
On B 1990 systems enter ‘‘TAPE GO”’ 
On other systems, do not press the CLEAR button, only the START button. 
2. Mount the appropriate MEMORY DUMP cassette. 
3. Switch to TAPE mode (with B 1825/30 enter ST). (Automatic on B 1990 systems.) 
4. If running on a dual processor, disable the slave processor. (Automatic on B 1990 systems.) 
5. Press START. (Automatic on B 1990 systems.) 
6. If the cassette does not start, note the value of all relevant registers. In this case only, press 

the CLEAR button before attempting to take the dump again. (with B 1825/30 enter SR). 
7. When register L = @AAAAAA@, switch to RUN mode and press START. (T register con- 
tains the release level). 

. Rewind the cassette. 

. Perform CLEARSTART. 

— do not press CLEAR on B 1800/B 1900, except for B 1825/30. 

— on B 1990 systems enter ‘““TAPE GO’’ 

10. Print the dump file by executing MEM.ANALYZER. 


\© 00 


If datacomm was running (always the case on B 1990 systems), dumps of the DCPs should be obtained 
by setting the DCPDUMP option in SYSCONFIG, then executing the MCS. On B 1990, the SPO DCP 
is dumped automatically on CLEARSTART, if the SPO DUMP option in SYSCONFIG has been set. 
A SPO DCP cannot be dumped by setting DCPDUMP in SYSCONFIG. 

How To Trace A System Loop 


A loop is detectable by the fact that the system does not respond to SPO input or the interrupt switch. 
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If this occurs, execute the following procedure: 


1. Press the HALT button. 

2. Display the A register (CR24 on the B 1830). 

3. Change the system to single microinstruction mode. 

In this mode, each time the system is started it executes one microinstruction, then halts. Re- 
cording the A register gives the address of the current microinstruction. When ihe values repeat, 
the loop has been identified. 

4. Press the START button and note the A register value. Repeat until the A register displays 
the same value as first displayed. If that value does not reappear after pressing START about 
20 times, the loop is not a small one. In this case, proceed to the next step. 

5. Take a system dump. 


When submitting an FCF for a system loop problem, please indicate on the Memory Dump listing the 
contents of the A register for the extent of the loop. 


List of Possible Halts (in L Register) 


c represents the channel number and d the drive number of the disk to which the dump file is directed. 


@Dc000d@ Dump is complete (dump file DMFILO00) 
@Dcnn0d@ Dump is complete (dump file DMFILOOnn) 
@Foide Dump filesize error. . 


The size of the dump file can be deduced from the contents of the LR 
register, according to the following list: 


@FFFFF0@ 11746 sectors (2 M-bytes) 
@800000 @ 5872 (1 M-byte) 

@700000@ 5138 (896 K-bytes) 
@600000@ 4404 (768 K-bytes) 
@500000@ 3670 (640 K-bytes) 
@400000@ 2936 (512 K-bytes) 
@300000@ 2202 (384 K-bytes) 
@200000@ 1468 (256 K-bytes) 
@100000@ 734 (128 K-bytes) 
@0F0000@ 689 ( 64 K-bytes) 

@Fc002d@ Not enough space in the disk directory. Enter in the L register the 


parameters of the drive on which the dump file is to be created. 


@F¥c003d@ Not enough space on the designated disk. Enter in the L register the 
parameters of the drive on which the dump file is to be created. 


@Fc004d@ An error occurred while reading or writing the dump file to disk. Pressing 
START causes 10 retries to be performed. Enter in the L register the 
parameters of the drive on which the dump file is to be created. 


If any one of the above halts occurs, the memory dump procedure can be restarted by entering: 
LB the channel number , 
LF the drive number 

of the pack on which it is desired to create the dump file. 
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@FF0000@ A cassette parity error occurred. 


@AAAAAA@® Switch to RUN mode and press START to continue (automatic on 
B 1990). 
Information given at the time of the halt is: 
— Release level in register T. 
— Julian compile date in register Y. 
— Dump file size in register X. 
Channel number in register S2A. 
— Unit number in register S3A. 


I 


Dump Failures 


If the dump cannot be taken because of ‘“CASSETTE ERROR” refer to ‘‘Cassette Error’’ earlier in 
this section. If the dump cannot be taken for some other reason and this occurs after more than one 
attempt, the only way to get a dump is to press CLEAR and START (MTR GO on B 1990) and reload 
the cassette. However, this means that all status, registers, STACK and scratchpad values are lost and 
subsequently DCP dump cannot be obtained. 


One of the reasons why a dump file cannot be created is if the system pack was seeking when the 
interrupt occurred. 
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SYSTEM HALTS DOCUMENTATION 
System Halts 


Most of these halts are traps for conditions that should not occur. When a halt occurs, a value is dis- 
played in the L register as listed below. 


WHEN THE SYSTEM HALTS TAKE A MEMORY DUMP AND SUBMIT AN FCF (SEE ME- 
MORY.DUMP EARLIER IN THIS SECTION). IF DATACOMM WAS RUNNING WHEN HALT 
OCCURRED, DCP DUMP(S) SHOULD ALSO BE OBTAINED (SEE DCP. ANALYZER EARLIER 
IN THIS SECTION). 


THE EXCEPTIONS TO THESE HALTS ARE DENOTED BY jf. THESE ARE CONDITIONS 
WHICH ARE RECOVERABLE BY USER ACTION. THE ACTION REQUIRED iS [INDICATED 
BY THE NATURE OF THE HALT. 

The system cannot be restarted, unless specified. 

Where ‘‘PRESS START”’ is advised, the command on the B 1990 is to enter ‘GO’’ and press XMT. 
CLEARSTART Halts 


*** ALL CLEARSTART HALTS SHOULD BE RECOVERABLE BY THE USER RESOLVING THE 
EXCEPTION CONDITION”’ 


C00001 SYSMEM not found. 

C00002 SYSMEM DFH corruption. 

C00003 BILINTERP not found. 

C00004 SYS-SUPERUTL not found. 

C00005 TL not found. 

C€00006 SYSCONFIG not found. 

C00007 SYSCOMNFIG File type not = @22@ or 


SYSCONFIG machine type not in range @51@ ~— @60@ 
NOTE @5118@ = B 1800, @5119@ = B 1900, @S11A@ = B 1990 


C00008 TRACE not found (internal, press START to resume). 
C00009 MCP not found. 
CO000A MCP file type not = @1C@ 
C0000B System disk not write enable. 
Co000C System disk not ready. 
C0000D Other system disk exception. 
Press START to start again. 
COO000F CRT SPO exception. 
00010 Soft console exception (B 1830). 
C00011 Invalid Data Comm configuration. (both DCP-1 and DCP-3/4 present). 


The system can be restarted with a correct setting of the channel mask 
using the maintenance panel toggles. 


C00012 Memory parity error. 

C00013 System disk AVR failure (Available Table full). 

C00014 Cassette parity. (See ‘‘Cassette Errors’’earlier in this section.) 

CO0015 Table error. One of the tables, for example Device Control Block or Channel 
Control Block contains an invalid value. Check system hardware 
configuration. 

C00016 Bad GEM configuration. 

C00017 Bad Disk Header (DFH of system file not of expected format). 

2032801 
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Cx00FF An I/O interrupt has been waited from a channel for 25.6 sec. 
The value of x is the Channel number. 
Check peripheral status and if good, press START to resume. 


MCP Halts 
SCL Resident 
4A0000 Cannot open SYSLANGUAGE file. 
4A0001 Invalid fetch value on read (in X). 
VM 
4B0002 + Recoverable error, press START to continue. 
4B000F Fatal error, memory corrupted. 
Global 
4D0000 + Console interrupt, press START. 
4D0001 + Memory parity error. 
T contains: card and chip address decode and syndrome. 
4D0002 - READ or WRITE out of bounds occurred. See CD register. 
This is detected in the SCHEDULER. 
4D0003 Attempt to schedule a job while its ICB.ADDRESS is zero. 


This is detected in the SCHEDULER. 
Mix number is in S10A. 

4D0004 t Attempt to schedule a job with an empty STACK.LIST (probably an 
interpreter error). Replace interpreter. 
This is detected by the scheduler. 
Mix number is in SIO0A and ICB.ADDR in SO9A. 

4D0005 Attempt to schedule a job with an FIB.LREQUEST.ATTENTION bit which 
does not correspond to an FIB segment. 
This is detected by the LOGICAL-IO selector. 
Mix number is in S10A and ICB.ADDR in SO9A. 

4D0006 Attempt to schedule a job with the FIB.REQUEST.ATTENTION bit set. 
The FIB segment type is valid (01), but is not in memory. 
This is detected by the LOGICAL.IO selector. 
Mix number is in S10A and ICB.ADDR in SO9A. 

4D0007 Attempt to schedule a job with the FIB-LREQUEST.ATTENTION bit set. 
The FIB type is valid and present in memory, but PHYSIO did not put a 
fetch value in the FIB.REPLY word. Early return — Wait bit has 
disappeared. 
This is detected by the LOGICAL.IO selector. 
Mix number is in SIOA and ICB.ADDR in SO9A. 

4D0008 ICB.STACK overflow. 
The error is detected by COMMUNICATE.SWITCH. 
Mix number is in SIOA and ICB.ADDR in SOSA. 

4D0009 READ or WRITE out of bounds occurred (see CD register). 
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As this error is detected by COMMUNICATE.SWITCH, the faulty module 
can be identified when analyzing the dump. 
Mix number is in SI0A and ICB.ADDR is in SO9A. 

4D000A Same as 4D0009. 

4D0010 Attempt to communicate with a non-existent resident module. The X 
register contains the desired module number. The T register contains: 
module number — displacement. 
The faulty module can be identified when analyzing the dump. 
Mix number is in SIOA and ICB.ADDR is in SO9A. 

4D0011 Attempt to communicate with a non-existent overlay module. The X 
register contains the module number multiplied by 12. The T register 
contains: module number — displacement. 
The faulty module can be identified when analyzing the dump. 
Mix number is in S10A and ICB.ADDR in SO9A. 


4D0012 BOOTSTRAP does not find an empty slot in the Mix table. SCL is the 
faulty module. 
4D0013 Master tries to execute Slave reserved micro code. 
SCL Handler 
630002 Previous op-code sent to the SPO was TEST.WAIT.RECEIVE. 
630006 Invalid fetch value after a Load Data Segment (in X). 
631000 Pack error (System Pack Lockout). 
SCL Input 
640002 Invalid fetch value after a load Data Segment (in X). 


PHYSIO Resident 


FO000D FCB queued twice. 

FOO00E FCB not queued while in FCB delink routine. 
FOOOOF FCB queue link error. 

F00010 DCB not queued while in DCB delink routine. 
- F00011 DCB queue link error. 

F00012 System disk not ready. 

F00013 Invalid status count while in disk Test.Op. 
F00021 Invalid status count detected while in Handle Data Transfer. 
F00024 FCB error in NOT-READY handling. 

F00025 FCB error in restart on NOT-READY routine. 
F00026 Status is INPUT while in OUTPUT. 

F00027 Status is OUTPUT while in INPUT. 


Physical I/O Overlay Loader 


These halts are caused by a READ or a SEARCH problem on the following overlay modules. The 
system may be restarted after these halts. 


FF0001 Disk open old file overlay. 
FF0002 Disk open new file overlay. 
FFO0003 Disk close overlay. 
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FF0004 ‘Disk areas allocation/change overlay. 


FFO005 Disk A.V.R overlay. 

FF0006 ICMD AVR/(R/W)/OPEN/CLOSE ies 
FF0007 Disk Purge overlay. 

FF0008 Disk crunch overlay. 

FF0009 Single device open overlay. 

FFOOOA Single device close overlay. 

FFOOOB Reserved for future use. 

FFO00D Disk RL OPEN unlabelled disk overlay. 
FFO00E Single device A.V.R overlay. 


Data Communication Haits 


DC0014 Neither Buffer 1 nor Buffer 2 can be transferred. A Read is requested. 


System Dependent Fetch Values 


The I/O system failures mentioned in this section should not occur. However, if they do, instead ey 


as listed below. A “COMMUNICATE ERROR , DS/DP”’ message is . displayed. A Dump of. the ae 
gram supplies the Fetch value in the Communicate Parameter Area. 


However, it may be impossible to Dump the program if it remains in Terminating status. In this case, 
the only way to access the Fetch value is to get a Memory Dump when the minimum of programs 
remain in the Mix. 


When submitting an FCF however, a program dump is insufficient to determine the cause of the prob- 
lem within the system. Therefore, at the error state press the INTERRUPT button and obtain a mem- 
ory dump. The exception is when the problem is easily reproduced, in which case the SPO log, pro- 
gram(s), data files and other supporting evidence may be submitted without a memory dump. 


Physical 1/O 
PHYSIO Resident 


2010FF Indexed sequential SEARCH error. 

80F014 Invalid verb. Take a dump to find this verb in the FIB. 

80F015 Mix waiting I/O bit reset before the end of a communicate with wait 
variant. 

80F016 FIB terminating mask flag not reset after completion of previous I/O. 

80F018 Duplicate Read/Write/Close communicate on an active file. 

80FOIE Open communicate issued on an already opened file. 

80FOIF Disk close communicate issued on a non-opened file. 

80F020 Single device Read/Write device error. 

80F021 Sectors/Block = 0 while locating FIB Block Number in file. 

80F024 Communicate on disk FCB queued to an invalid device. 

80F033 No local SPO on system. 
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Disk Open Old File 


80F 120 
80F 122 


80F12A 


Disk Open New File 
80F201 
80F221 


80F222 
80F22A 


Disk Ciose 


80F313 
80F31E 


80F321 
80F322 


80F326 
80F32A 
80F3FF 


Area Allocation/Change 


80F40C 
80F414 
80F415 


80F42A 


Disk Purge 


80F701 
80F702 
80F707 
80F71E 
80F72A 


Disk Crunch 


80F801 
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Otheruse error. Take a program dump to find it in the FCB. 
End of file error: MAX.AREA.IN.USE is greater than the number of 


SYSMEM lock error: the device status is locked. Take a Memory dump to 
get the device status in the DCB. 


Directory index error: a SEARCH of an entry of all ‘‘8080..’’ is made but 
the entry does not contain ‘‘8080..’’. 

FIB size overflow: (number of buffers * buffer size) exceeds (65535 — 

26). 

Exceeding file size. See the FIB in a program dump. 

SYSMEM lock error. Same as 80F12A. 


Invalid user count: take a program dump to get the value in the buffers. 
FCR structure error: for a CLOSE REMOVE or CLOSE LOCK, the file 
is no longer in use when its FCB is searched for. 

Buffer size is not multiple of record size. 

EOF error: file size computed from the EOF pointer exceeds the maximum 
file size. 

Attempt to purge or change name of MCP. 

SYSMEM lock error. 

Close Merge Restart. 


Area allocation out of the available table limits. 

Verb error. Same as 80F014. 

Program status error: the program is not in WAIT status while an 
ALLOCATION or a CHANGE needs a WAIT status. 

SYSMEM lock error: same as 80F12A. 


Area has been allocated with size 0. 
Area allocation error. Same as 80F804. 
Available Table size error. 

FCB structure error. Same as 80F31E. 
SYSMEM lock error. Same as 80F12A. 


Last area size computed from the EOF pointer exceeds the size allocated 
for the last area. 
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80F802 
80F803 
80F804 
80F807 
80F813 
80F81E 
80F820 
80F821 
80F822 
80F82A 


Single Device Open 
20F9FF 
40XX13 
80F91E 


Single Device Close 


80FA20 


Logical I/O 


Area has not been allocated. 


Area length error. 

Attempt to release an area comprised in the available table. 
Available Table size error. 

User count invalid. Same as 80F313. 

FCB structure error. Same as 80F31E. 

CLOSEMODE error: CRUNCH flag is reset. 

Record size error. Same as 80F321. 

EOF error. Same as 80F322. 

SYSMEM lock error. Same as 80F12A. 


Device cleared or LT’ed. 
LT device in use by MIX # XX. 
Duplicate Single Device Open. 


Invalid MYUSE. See FCB in the program dump listing. 


Note that if bits CD(2) or CD(3) are set, a READ/WRITE has previously occurred. 


80FF10 
80FF20 
80FF30 
80FF40 
80FF50 
80FF70 
80FF80 
80FF90 
80FFA0O 


80FFFO 


Bit CD(2) or CD(3) is set when entering in the resident. 

Buffer status is invalid in the Can I Read again routine. 

Buffer status is invalid in the Sequential Write routine. 

Buffer status is invalid in the Get routine. 

Buffer status is invalid in the Put routine. 

Bit CD(2) or CD(3) is set when entering in the Open Segment. 

FIB Data Segment is not found in the IFNB Segment. 

Bit CD(2) or CD(3) is set when entering in the Logical Close Segment. 
Attempt to divide by zero due to an invalid value of 0 in an FPB or a 
KFPB field. 

Bit CD(2) or CD(3) is set when leaving logical I/O module. 


Data Communication Errors 


If one of the following Data Communication errors occurs, the message: 


<285> DC ERROR xx ON DC y 


is issued, xx being the decimal value of the L register last byte, and y the DCP number. 


These values are for information only. They indicate a system problem which should be communicated 
to the Burroughs Service Department. 
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XX 


01 Memory corruption problem. A message is to be added into the input 
queue. The message link cleared at dequeue available space time is no 
longer cleared. 


02 Cannot lock the Host to send a Nack message after a B 1000 No Space 
Condition. 

03 The message length given by the Liege header is less than the number of 
bytes contained in the Host. 

04 The message length to empty is still greater than 255 bytes, and the 
transfer in count supplied by the Host is less than 255 bytes. 

05 During a Read sequence (B 1000 in receiving mode) a service request is 


issued by the Host with the corresponding status: 
HTC.READ = TRUE 


HTC.BUSY = FALSE 
HTC.BUF1 = FALSE 
HTC.BUF2 = FALSE 
06 During a Write sequence (B 1000 in sending mode) a service request is 


issued by the Host with the corresponding status: 
HTC.WRITE = TRUE 


HTC.BUSY = TRUE 
HTC.BUF1 = TRUE 
HTC.BUF2 = TRUE 
Therefore there are no free buffers to continue the Write. 
07 When the DCP is in sieeping mode, the oniy valid sequence is READ. 
The HTC status is located in S6A. 
08 Invalid DCP status. 
09 For a new input message, the transfer-in count of the first hardware 
buffer is less than 6 bytes. 
10 The sequence byte is wrong. A buffer may be iost. 
11 Invalid HTC status (see S6A). 
12 Cannot find MTRINTERP. 
13 DCP is in No Space condition and the next interrupt gives an invalid 
HTC status (see S6A). 
14 Channel control word corrupted. 
15 Transfer-in count value set to zero during a Nack read phase. 
16 Invalid Liege Header during the Nack Read phase. 
17 During a Read phase, the transfer-in count is less than 255 bytes while 
Busy bit is true. 
18 During a Read phase, the transfer-in count is less than 255 bytes and two 
buffers are filled. 
19 The HTC CNTL register is null after a test and lock command. 
21 Protocol error. 
26 Firmware halt (take DCP Dump). 
27 Unexpected no. of bytes received by HOST DMA. 
28 Unexpected status received while in ROM mode. 
29 DCP Memory parity error. 
30 Unexpected Jump in ROM 
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APPENDIX A 
GLOSSARY OF TECHNICAL TERMS 


ADDRESS 
A disk is divided physically into tracks and sectors, both numbered sequentially from zero upwards. 


Ses 


These ‘numbers’ are referred to as ‘addresses’. The MCP uses this address scheme to quickly locate 
da 


a on disk. 


. 


ALPHANUMERIC 
Consisting only of letters of the alphabet plus the ten numeric digits; that is, not containing any other 
special characters. 


APPLICATION PROGRAM 
User program that performs day-to-day functions such as invoicing, printing, inventory reports, etc. 


ATTRIBUTE 
Characteristic or quality. 


BACK-UP 
Term used to describe the method of insuring that copies of files exist to standby as alternatives. 


BINARY-CODED DECIMAL (BCD) 

A method of coding numeric information in 4-bit units representing 0 as bits 0000, 1 as bits 0001, 
2 as bits 0010, up to 9 as bits i001. For example, the number 1607 in BCD would take four 4-bit 
units (2 bytes), coded as 0001 0110 0000 0111. 


BOJ 
‘Beginning of Job’. The term used to notify the operator that a program has entered the ‘mix’ and 
has just started running. 


BSMD 
Abbreviation for ‘Burroughs Super Mini Disk’. 


BYTE 
One alphanumeric character of data. 


CHECKERBOARDED 

Term applied to any disk having available spaces of varying sizes scattered about the disk among files. 
The term can also be applied to memory in a virtual memory system where ‘locked’ or ‘save’ areas 
are scattered through the memory in such a way as to impede getting overlayable memory areas of 
sufficient size for optimum throughput. 


CMS 

Computer Management System. A set of interrelated specifications for system software, including level 
language compilers, object-code formats, operator interface and data communications, which 
Burroughs has implemented on machines of different hardware characteristics. 


COMPILATION DATE 
The date on which a programmer’s source code was compiled: that is, the creation date of the execut- 
able object program. 


COMPILERS 
Group of system programs that convert instructions written by a programmer, in a language such as 
COBOL or RPG, into a form which can be run or interpreted by the hardware or system software. 
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CONFIGURATION 
Term used to describe the arrangement of various hardware devices in a particular system. 


DATA FILE 
A set of information usually on disk, which is used as data to be input. 


DEFAULT VALUE 
Usually a meaning that a program will assume if not instructed otherwise. 


DESTINATION 
Disk to which information is being transferred. 


DISK DIRECTORY 
List, on Track 0, of file names, locations on disk, and sizes. Similar to a table of contents. 


DISK FILE 
Set of information residing on a disk medium, collectively referred to by its name, ‘file-name’ and the 
name of the disk on which it resides (‘disk-name’). 


DISK NAME 
Name by which a disk is known to MCP. Every disk medium has a ‘label’ of information written to 
it during disk initialization, and the disk name is part of the ‘label’. 


DUAL-PACK FILE (MULTI-VOLUME FILE) 
A file that resides on two separate disks or logically defined disks (for example, DKA, DKB). 


EOJ 
‘End of Job’. The term used to notify the operator that a program has terminated. ‘Abnormal’ end- 
of-job occurs when a program is terminated prematurely due to an error condition. 


EXECUTION 

The running of a program is termed ‘program execution’. The operator can execute (or start) a pro- 
gram by entering the name of the program desired (or disk-name/program if program resides on user 
disk). When a program is ‘executed’, it enters the ‘mix’ and is assigned a ‘mix number’ by the MCP. 


FAMILY (GROUP) OF FILES 
Two or more disk files having at least the first letter of their names in common. For example, ‘PR020’, 
‘PRFILE’ and ‘PASM1’ are members of a family of files that could be referred to as ‘P—’. 


HARDWARE 
Term referring to all equipment on the system. Line printers and disk cabinets are examples. 


HEXADECIMAL (‘HEX’) 

A number system based on root 16, in contrast to common ‘decimal’ system based on root 10. To 
provide additional symbols, the letters A through F are used, so that counting proceeds thus: 0, 1, 
2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F, 10, 11, 12 ... for decimal numbers 0 through 18 ... 


INTERPRETER 

A system software item used as an intermediate step in the running of a program. Instead of using 
a compiler to transform programs directly to machine instructions which can be run by the processor, 
a compiler may transform the program to an intermediate form (called ‘S-code’). The S-code can be 
‘interpreted’ by the interpreter, that is, translated into machine instructions that can be run by the pro- 
cessor. 


Ss 


INTRINSIC 

A ‘command’ used by the operator to direct the activities of the MCP. Intrinsics are actually a part 
of the MCP and therefore will never by seen on a disk file listing or in the ‘mix’. Examples of intrinsics 
include ‘DS’ (discontinue the processing of a program) and ‘DT’ (retrieve or change system date). 


KEYFILE 
File used by system as an index to a master data file. 


LABEL 
A small space of disk on tape indicating the medium’s contents, name, etc. A disk label may be created 


during the initialization process, and a tape label is created when the tape is purged. 


MAIN MEMORY 
Circuit boards inside processor where program code and data in immediate use are held. 


MCP (‘Master Control Program’) 
Program which is the central part of the CMS software system. It handles hardware devices, communi- 
cates with the operator, and controls processing of programs. 


MIX 

Term applied to the mixture of programs running in a multi-programming environment. A ‘mix-num- 
ber’ is a number which is assigned by the MCP to a program when it enters the ‘mix’. A ‘null’ mix 
is when no jobs are running. The program’s name and mix number can be used by the operator to 
refer to a varticular program in the ‘mix’. 
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MULTIPROGRAMMING 

One processor working on more than one program at a time. Processing can be shared on a ‘round- 
robin’ basis, and computation can be overlapped with input/output if there is more than one program 
‘in the mix’. 


ON-LINE 
Term used for equipment or media currently used as part of the system. 


PACK 
Synonym for ‘disk’. 


PERIPHERAL 
Hardware device used as input or output. Examples are line printer, disk drive unit, console keyboard. 


PURGE 
To erase. When disks or tapes are ‘purged’, their contents are lost. 


SECTOR 
A disk is divided physically into data storage spaces called sectors, numbered sequentially from zero 
upwards. Each sector is 180 characters in length. 


SOFTWARE 
Term referring to programs and files, as distinct from the ‘hardware’ of the actual machine. 


SOURCE DISK 
Disk from which information is being transferred. 


SOURCE FILE 
A disk file containing statements (instructions) written by a programmer in a high-level language such 
as COBOL or RPG, before it has been transformed into a program which can be run. 
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STAND-ALONE PROGRAMS 

Programs that do not run under control of the MCP. In particular, functions of general use to all 
B 80 users are held in a disk file called ‘SAU’ (Stand Alone Utilities). Examples include LS (list disk 
name and sizes), and RL (relabel a disk). Loading and execution of SAU is done with no need of 
the MCP. Refer to section 8 for details. 


STARFILE 

A small disk file optionally used at the start of most CMS-common utilities. The information in the 
starfile is used to build up the initiating message for the utility, which could also be entered by the 
operator on the SPO. Starfiles are also called ‘macro-files’. 


SYSTEM DISK 

The disk containing the copy of the MCP that is currently in use. Note that a user disk may aiso con- 
tain MCP code files, but only the disk containing the MCP that is in use since the last warmstart is 
the system disk. There can be only one system disk at any time during operation. System disks cannot 
be used as system disks on more than one CMS product (see section 2 for details). 


SYSTEM FILE 
A disk file which is used by the system software. Special control is placed on these files to minimize 
the danger of accidental removal from the disk (see RM utility). 


SYSTEM SOFTWARE UTILITY 

A program of general use to all users, as opposed to an application program which performs a 
particular user’s task using day-to-day tasks, such as invoicing. Examples of utilities include COPY 
(copy files from one medium to another) and RM (remove files from a disk). 


THRASHING 
Thrashing is the state where the amount of user work done by the system is very small as compared 
to that done on its housekeeping. 


USER 
Any disk available to the system that is not a system disk. 


VIRTUAL MEMORY 

A software technique, implemented in the MCP, of allowing programs to execute (or several to execute 
together) when the total program memory requirements exceeds the amount of memory physically avail- 
able. Some of the executing program’s code and data, which is not in immediate use, is stored on disk 
media and not in main memory. When the code, or data, is required, space is made for it in main 
memory and the information read back from disk. To make space in memory, it may be necessary 
for the MCP to re-use some memory which has previously been used by the program and is not re- 
quired at this moment. Before re-using memory containing data that could have been updated, the 
MCP writes this segment of memory to the program’s ‘virtual memory file’ on disk. This technique 
also applies to the code and data of the MCP and other system software. 


VOLUME 
Synonym for ‘disk’. 


WRITE INHIBIT 
To prevent disk on tape media from being written to by a program. The manner in which this is ac- 
complished depends on the medium (see B 80 or B 800 System Operator manuals for details). 


A-4 


WRITE PERMIT 


To allow any disk or tape medium to be written to by a program. The manner in which this is accom- 
plished depends on the medium (see B 80 or B 800 System Operator manuals for details). 
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APPENDIX B 
COMPLETE RAILROAD DIAGRAMS 


This appendix gives the railroad diagrams for all the CMS-common intrinsics and utilities, including 
SORT and CO, in alphabetical order. These diagrams give the complete input message formats, for 
ease of reference. 


For details of the meaning of these messages, refer to text. 


In the following diagrams, the <ex-option> is defined as: 


and <file-name> is defined as: 


< disk-id > / Ea heey ea a 
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AD Intrinsic 


AD 


< mix > ii (ei eee ce < peripheral > —_—_—_—_ 
/ <progname > 


ADD Utility 


< tape-name > ———> 


< file-name > 


< disk-name > 


< family-name > 


AMEND Utility 


<disk-name > —— / 
AMEND a Sareea repel Im < filename > 


A TABSTOP 


< number > 


AP Intrinsic 


—— AP — <pack-id >/ 


< peripheral > 


ON 
AX Intrinsic 
—— AX bs ciel Ramee aa + 
/ <progname > 
CH Utility 
< group-name > < DATA> < group-name > 
CH TO 
< file-name > < file-name > 


CL Intrinsic 


cL 


< peripheral > ——_ 


CHECKADUMP Utility 


CHECKADUMP —————-_ < library-tape-name > WITH < disk-name > 


ae < file-name > =<" 
on <BOTH > —b-L —___ 


< group-name > 


CHECK.DISK Utility 


6 


<start-address > < end address > 


CHECK.DISK < disk-id > < start-address > —————--——_ <_ number of sectors > 
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ng Be i ee 
CO Utility 


Version 1: 


< disk-id-1 > / 


co 


< disk-id-2 > / < program-id > 


(*) 


< disk-id-3 > 


< compiler-name > e- > 
(*) 


(1) ——— <compiler-option > 
= SE Uh he ne ee oT 


(1) ———  < message-statement > 


(1) ———« < patchfile-statement > 


(1) ——— <sourcein-statement > 
(1) ——— <sourceout-statement > 
(1) 
(1) 
(1) 
(1) 
(1) 


< file-statement > 


< workfile-statement > 


< printout-statement > 


< icfile-statement > a 


< controlfile-statement > 


< errors-statement > 
(1) ———  < dp.names-statement > 


(1) ———-_ <_ masterfile-statement > 


(*) — Indicates allowed position of macro call 


SYNTAX 


SY 
Ll 


LIBRARY 
SAVE 


GO 
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CO Utility (Continued) 


MESSAGE — < message text > —_—_——_ 


PRINT. ————+ 


RESET 


Examples: MESSAGE $ LIST XMAP 
sets LIST and XMAP 


MESSAGE $SET LIST RESET XMAP SET CODE 
sets LIST and CODE, resets XMAP. 


>—— MESSAGE $ <option > —+~——__ 


Example: MESSAGE $LIST $XMAP SNOWARNING 
sets LIST and XMAP, resets WARNING 


NAME — < file-name > 


MFID — < multifile-id > 


PATCHFILE 


FID < file-id > 


DEVICE —— < hardware > 


FILESIZE ——— < integer > 
1 NO.BUFFERS ——= < integer > 
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CO Utility (Continued) 


1 NAME — < file-name > 
1 
1 MFID —= < multifile-id > 
SOURCEIN 
1 FID < file-id > 
1 DEVICE ——— < hardware > 
1 NO.BUFFERS — < integer > 


fi \—— NAME — < file-name > 


1 MFID — < multifile-id > 
—— SOURCEOUT 
1 FID < file-id > 
1 DEVICE —— < hardware > 
1 — FILESIZE —— < integer > 
1 RECORD —— < integer > 


RECORDS.BLOCK —— < integer > 


BLOCK —— < integer > 
1 NO.BUFFERS ——— < integer > 


— WORKFILE — MFID — <multifile-id>—— 
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CO Utility (Continued) 


DEVICE < hardware > 
NO.BUFFERS —— pee 


< integer > = 
DONTBACKUP 
x DONTCARE 


| L. mUSTBACKUP at NAME 


PRINTOUT 


< file-name > 7 


NAME —= < file-name > 


yaa 


fj“ MFID — < multifileid > 


< file-id ae 


— CONTROLFILE 


FID 
DEVICE —— < hardware > 
1 NO.BUFFERS — < integer > 


NAME —— < file-name > 


MFID —=— < multifile-id > 


read ICFILE 
——  < file-id > 


FID 


DEVICE —— < hardware > 
1 NO.BUFFERS — < integer > 
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a Be 
CO Utility (Continued) 


MASTERFILE (1) NAME  < file-name > 


(1) 
(1) 
(1) 
(1) 


MFID < multifile-id > 
FID < file-id > 
DEVICE < hardware > 


NO.BUFFERS < integer > 


ERRORS NAME < file-name > 


MFID <multifile-id > 
(1) ——-— FID. <ffile-id>$ —_—__—I 


FILESIZE < integer > em ie ee 


DP NAMES NAME < file-name > 


MFID < multifile-id > 
FID < file-id > 


(4) a FILESIZE < integer > 


Version 2: 


EX < disk-id > / CO — MX 


< program-name > —= <compile-tag > 


ALL 


PRINTOUT ———————— 9—dDEVICE ————_ < hardware > 
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a a eo 


CO Utility (Continued) 


Where <program-name> is defined: 


El < disk-name > / el ete name> 4 
Pate: Par eee 


EX < disk-id-1 >/ co 
cll < compile-tag > shale < line-number > sails! 


Where <program-name> is defined: 


RESTART 


< program-name > ——_—_—> 


< disk-name > / < file-name > 


L-NAME” 


< compiler-tag > 


2 ee eee iii 
EX < disk-id1 > CO —— CLEAR 


ALL 


Where <program-name> is defined: 


< disk-name > / < file-name > 


“NO—NAME” 


COMPARE Utility 


< file-id > 
COMPARE be. NOPRINT oe <disk-id > / Iie < group-id > i with} ————> 
<file-id > 
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eee 
COPY Utility 


* < file-name > 


’ 


& COMPARE < group-copy > 


>— cory 
<s-file> —— TO —— <d-file> 
<group-copy > is defined as : 

<KEY> SHARED 
FREE 


EBCDIC 


>— <group-name-1 > To ————> 
< disk-id > / < family-id > AT HOSTNAME <host-id > PACK EBCDIC 
<s-file > is defined as : 
PACK 
CRD 
1 MTP 
<BOTH > 
RECOVER 
1 
< KEY > 
SHAR ED 
1 
FREE 
< disk-id > / AT HOSTNAME <host-id > 
J file-id > 
1 RECORD —<nr> 
1 BLOCK — <nb> 
1 = TAPE.MARKS #< nt> 
1 NO.LABEL 
1 EBCDIC 


= < r-spec > <a 
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COPY Utility (Continued) 


<d-file > is defined as : 


rc 1 — RECORD —— <om>- 
| co BLOCK Sit 
1 FILESIZE —— <nf> 
1 SINGLEAREA 


1 CRUNCH 
7 \~ EXTENDING 


EBCDIC 
NO-—LABEL 
AT HOSTNAME <host-id > 


ie disk-id > 7 
< file-id > 


<r-spec > is defined as : 


< r-count > 
< record-key > 


< record-key > 
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CP Utility 


cP 


< integer > 


< integer > 


CREATE Utility 


= 5 < filename > 
| TABSTOP < number > 
CREATE =o < f-spec > 


<f-spec > is defined as : 


RECORD <nr> 
S BLOCK <o> 
FILESIZE ———— << nf > 


< disk-id > es A 
< file-name > N 


CRUNCH 


C < disk-id > 1 
EXTENDING < file-name > 


CTL Intrinsic 
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i *-: NO LABEL re na 


|| ee ee eo ee ee 
DA tt < diskid > 1. / <fileid > ——t+_+_4+__1________1____| 


OF < file-id > 
TEMPORARY 
@ <sector-number > @ 


< sector-number > 


NAMES 


OF <file-id > 
TEMPORARY 


< number > 
@ <numbrt > @ ———_—_J 


AVAIL. TABLE ALL 
AVAIL 
BAD 
INVALID 


< number > 
@ <number > @ 


< family-id > 


KFPB OF 
& OF 


2032801 
B-13 


DA Utility (Continued) 


END ————_______| 
LABEL ——___| 
DISPLAY —————_——_| 


PPIT ALL 
NAMES 
OF <file id> 


< number > 


READ 


NEXT 
< number > 


@ <number > @ 


DB Intrinsic (not on B 900) 


DB —— < mix > 


< file-id > 
TO <pack-id >/ <fileid > 


/ <progname > 


DC Intrinsic 


—_———— pbc ———_ <text> ————] 


DM intrinsic (B 1000 only) 


—— DM 


< mix > / <progname > 


AT © [Bs sama < line number > 
< psn > < spn > < pea > 


DP Intrinsic 


—— DP ————_ <mix > / <progname > ————+] 


DS Intrinsic 


— oS — <mix>/ < progname > —————| 


DSKUTL Utility 


Je < disk-id > = 
DSKUTL IN UNIT.FDA FILES 


<nnann> ——— OWNER —— <“‘aaaaaaaaaaaaaa”’ > —————> 


>————- SERIAL ———— < ssssss > 


BOOTSTRAP en ere ae <file-id > 


TEST.PATTERNS 
TEST.PATTERN 


<MTR > 
<COLDSTART > 


@ <hex.pattern > @ 
“ < ASCII pattern >" 


a oe 
RF UNIT.FDA FILES <nmnnn > —— OWNER <“aaaaaaaaaaaaaa’ > —> 


DSKUTL 


>———. SERIAL <ssssss> BOOTSTRAP <disk-id >/ < file-id > 


<MTR> 


<COLDSTART > 


B3S00 
<sector address > “—” < sector address > 
DSKUTL ——— LIST A < sector address > < number of sectors > 25 
. 
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DSKUTL Utility (Continued) 


DSKUTL 


>— <disk-id > 


BOOTSTRAP awe < file-id > 
< disk-id > : <COLDSTART > 


DT Intrinsic 


— DT 


| 1 | 
bee mm > /<dd>/<yy>4 &<hhmm> J 


DUMP 


eee DUMP & CHECK UPDATED PRINT DIR TO <tape-name > —> 


< file-name > 


FROM — = < disk-name > < BOTH > 


< family-name > eet 
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DUMPADISK Utility 
Format 1 


DUMPADISK PRINT.DIR 
This function lists the disk directory. 


Format 2 


PRINT.DIR LOAD & CHECK FROM < disk-id > 
SP aaa pt ean LN ON [Ase rc ES EE 
TO <disk-id > 


where < file-list > is defined as : 


< family-id > <BOTH > 
eats i rye aes cae ees 


Format 3 


PRINT.DIR DUMP & CHECK UPDATED 
DUMPADISK ea a ee ee) ace ye 
FROM <disk-id > 


ECMA Utility 
FROM <disk-name > < file-name > 
DUMP 
ECMA.LD 
UNLOAD 
TO <disk-name > RECORD < number > 
BLOCK < number > 

ECMA.LD LOAD 
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EX Intrinsic 


ee fee 
EX < pack-id > 


< real store > 


FILE i <internal filename > — =-7- < pack-id > / < file-id > 


eS aeeiaie 


= < text> su 


FD Intrinsic (B 90 only) 


—— FD SPA 


< offset > 


> he < width > 


For terminal SPOs running Multiple Terminal SPO (MTS), B 90 systems only: 


STATION ——————— rere See Da < width > ———_——_ 


FD 


FILEUTL Utility 


<cc > RN 


FILEUTL ———_______ 


FL Utility 
< disk-name > / < file-name > 
< group-name > 
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FS Utility 


< disk-name > / 


r < disk-name > / a 
FS < file-name > 


GO Intrinsic 


— GO—— <mix> >—————_—+ 
L / <progname > _I 


< filename > 


HELP Intrinsic 


—— HELP ———- <mix> ic. 
/ <progname > 


ICMD Utility 


Version 1 
< disk-id > 
< string] > 
Version 2 
< disk-id > 
ICMD—COPY < disk-name > / < file-name > TO i—_ 
< string] > 
< file-id > 
B (CMD ALIGN |__| 
< string 2 > 
2032801 
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ICMD Utility (Continued) 


Version 3 
< disk-id > < file-id > 
<string 2> < string 2 > 
< disk-name > / < file-name > FILESIZE < integer > 


Version 4 
<disk-id > 
ICMD—PG 
e— <stringi> 
Version 5 


< disk-id > < disk-id > < owner-id > 
ICMD—PG TO ft . 
< string! > < string] > 


IR Utility 


< string3 > 


END 
IR < offset > 


KA Utility 


<disk-name > / < family-name > 


KA < file-name > 


KA < disk-id >/ DSKAVL ———| 
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KEY.CHECK Utility 


KEY.CHECK NOPRINT disk-name / keyfile-name < BOTH > 


KX Utility 


— KX 
< disk-name > 
lL < number > — 


LB Utility 


END 
gles = oe ae 


LF Utility 


epee ! 


LG Intrinsic 


Lg ——_—____ 


LIST Utility 


* < file-name > 


’ 


— LIST 


< f-spec > 
<r-spec > is defined as : 


< r-count > 


< record-key > 
< record-key > 
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LIST Utility (Continued) 


< f-spec> is defined as : 


SHARED 


< filename > 


EBCDIC 
1 RECORD ——————. <;5> — 
1 BLOCK ————————._ < ps > 


1 TAPE.MARKS ———— <nt > 
1 NO. LABEL 
1 <KEY> 


LOAD Utility 


= eis LOAD & CHECK PRINT.DIR FROM —— < tape-name > _—> 
< file-name > 

< BOTH > 
< family-name > 


< page. height > aie > === <end.of.page > aie 


TO —— <disk-name > 


LOAD.VFU Utility 


DEFINE 


LOAD.VFU ——- DEFINE ——— < format.name > 


oe > <channel > eee eer 
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LOAD.VFU Utility (Continued) 


FORMAT 

LOAD.VFU FORMAT < printer.device > WITH < format.name > —_— 
LIST 

LOAD.VFU —=— LIST tee dele format.name > iF 

DELETE 

LOAD.VFU ——= DELETE —— <format.name > —4 

LR Utility 


< filename > < integer > <A> <D> 


< ASCENDING > < DISPLAY > 


LR < group-name > 


LS Intrinsic 


L¢ ———_—________| 


LT Intrinsic 
— LT ——— < peripheral > —— < translator > — 


MODIFY Utility 


MODIFY CODE.FILE | eae < file-name > — < modify-options >— , END 
 <disk-name >— / 


where < modify options > 


< file-attribute > — < file attribute value > 
FILE — < internal filename > 


PRINT.FPB 


< ppb-attribute > — < ppb attribute value > 
PPB 


PRINT.PPB 
2032801 
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MX Intrinsic 


— Mx 
< mix > 
/ <progname > 
ND Intrinsic 
—— ND < peripheral > ——— < density > — 


OL Intrinsic 


ee 
< device-specifier > 


PB Utility 


PB PRINT < file- spec > 


> 


(1)}——— ON <device_type > 
(1)—— BEFORE <date> 
(1) —— COPIES < number > 
(1) —— SAVE 
(1) —— FORMS 


<file> 


PBnnnnn 


{1)——- ON <device_type > 
(1) —— COPIES < number > 


nannnn (1) —— SAVE 


(1) —— FORMS 


ar PAGE < number> 
RECORD < number > 


< number > 


PB os < file.spec > BEFORE <date > 
eas eee ge 
AUTO ON < device.type > 


PB 
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PB Utility (Continued) 


PB 


LIST < file.spec > (1) —— ON <device.type > 


(1) ———— BEFORE <date> 


PD Utility 


SSS Se 


| arama < disk-name > / =) | 
< file-name > ? 


PD 


< group-name > 


PG Intrinsic 


PG —————————=_ <_ peripheral > —_+ 


< file-name > < option-list > 


where <option list> -— SYSTEM or S 
ERROR or E 
STATS 
DISPLAY 
BACKUP 
FROM <time spec> 
TO <time spec> 
ENTRY <number> 
MIX <number> 
INPUT 
OUTPUT 
<empty> 
DEVICE <device spec> 
PURGE 


where < time spec > is defined as : < date > 
L-— < time > 
<date > <time> 


<date> := { mm/o0/YY } 


PL 


<time> := } HH: MM : ssf 


2032801 
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PL Utility (Continued) — 


< device id > 


> < device spec > 3: = < device mnemonic > 


< device-id > ::= form DFA, CTB etc. 


< device mnemonic > ::= form DF, CT ete. 

PO Intrinsic 

—— PO —— < peripheral > ———_| 
PPID Utility 


< disk-id > 


a PRINT 


PR Intrinsic 


— PR — <mix> /< progname > A 
fb ° 
Cc 


RD Intrinsic 


RD < peripheral > ——_—_—_—_ 
RL Utility 
— RL < old packid jor eae <new packid >/ ——__| 
TO 
RM Utility 


< disk-id > / 


< group-name > 
RM 


< file-name > 


RY Intrinsic 


RY ——— < peripheral > ——+ 
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SCR Utility 


ae ee ee SCR i ae < disk-name > < disk-name > 
<SCR test list > 


iteration = the number of iterations of the subsection. 
Where SCR iest list is: 


<DCR test > CPU.IO < iteration > <MT.1O TEST > 


OTHER.IO < iteration > —————| 


Where DCR test is: 


—— DCR — ALL — <disk-name > ule <disk-name> 1 


or 


OPEN.FILES als 


— DCR —— < iteration > —— < disk-name > Hl disk-name 


READ.A ot |e M 
ss} 


READ.CYLINDERS WRITE.INDEX < records > READ.RANDOM — < sectors > 


records = the number of (data) records in the index file 
sector = the number of sectors to be read randomly. 


Where MT.IO test is: 


—— MT.1IO — < iteration > MT —— < reels > ———- CS —=— <drives > —— RECORDS — < blocks > + 


reels = the number of magnetic tape reels to be tested. 
drives = the number of cassette drives to be tested. 
blocks = the number of records to be written. 


SF Intrinsic (not on B 90) 


SF ———  < mix > <mfid > / 


/ < progname > <mfid > / <fileid > 
< fileid > — 
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SM Intrinsic 


< mix > 


< text > —_ 


SN Intrinsic 


SN < peripheral >——< serial no > + 
SO PRBK Intrinsic 


— so —— PBRK 


< packid >/ < filesize > 


OFF TO 


SORT Utility 


< key. statement > —————————._ <_ user. option. statement > a ee 


< tiie.statement > 


< file.statement > 
[ FILE 2 
FILES 
>—IN < mfid>/ <fid>—(— al PURGE ll < recordsize > ii < records per block ale 


petals en 
>— OUT <mfid>/ <fid>— ( TAGFILE 


DISK < recordsize > < records per block > 
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SORT Utility (Continued) 


< key.statement > 


mom ALPHA —— 
UA 
NUMERIC 


ASCENDING —— aa UN 


A SA 


DESCENDING 
D 
KEY (<location > < length > ) 
< user.op > 
‘ INDEX oy 
i | 
INPLACE NODUPLICATES 
MERGE DUPLICATES 
SYNTAX 1 
NOPRINT 1 
NO DISPLAY 1 
COMMENT < comments > 1 
FILESIZE <no-of-records > 1 
MEMORY <memory-size > 1 
WORKDISK <disk-name > 1 
SQ Utility 


VERIFY 

BEGIN END 
FROM mie < addr > TO nite addr > 
ALL 


FAST 


< number > 


SOQ —— < disk-name > 
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ST Intrinsic 


—_— ST 


ie Rane oe: 
/ <progname > : 
SV Intrinsic 


— Sv ——— < peripheral > ———_| 
SYCOPY Utility 


< integer > 


SYCOPY CPY 
CMP 
CCM 


IN 
a a: ae NAME <user-id > | 


i TAPE < tape-no > 


MRG 


SYSTEM 


Fl UPDATE NAME < user-id > 


QUT 


TEACH 
TAPELR Utility 
TAPELR <library-tape-name > 
TAPEPD Utility 
TAPEPD < library-tape-name > 


TL Utility 


TL < file-name > RECOVER REM.DUP 


TO PRBK Intrinsic 


TO Fe 
PRBK 
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UNLOAD Utility 


= ee UNLOAD — UPDATED PRINT DIR TO —— <tape-name > —> 


TG 


| — ey 
< file-name > 
FROM —— <disk-name > < BOTH = 
> 


Li< family-name 


UPDATE Utility 


N < tabs > < file attributes > 
UPDATE < filename > TO <new file-name > xl seen 


where < tabs > is 
i < tab position > a 


TABSTOP 


and <file attributes > is 
(1) CRUNCH 
(1) 


FILESIZE < integer > 


VF Intrinsic 


VF 


< peripheral > ——— <h> 


WL Utility 
WL 
XD Utility 


XD < disk-name > <address > < length > 
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APPENDIX C 
EXAMPLES OF PRINTED UTILITY OUTPUT 


This appendix provides sample output from some of the CMS-common utilities described in section 
4. 


SPO and console input messages are underlined. Some utilities use SPO display messages for output. 


Output print ding use a printer if one is available, or (for a B 80 or B 800) a console file. Print 
files can be either labelled or unlabelled: if file is labelled, the name is printed following 


DATA 
at the beginning of the listing, and 
2END 


at the end of the listing (for example, refer to the PL output listing). In this appendix, print files are 
shown boxed in: other output is on the SPO. 


The meaning of the input messages are given in section 4. The utilities are given here in alphabetical 
order. 


2032801 C1 


-—————_ eee 
CHECK.DISK 


1/0 MIX MESSAGE TEXT 
NC. 
I 30 CHECK.DISK SOGDOCi 
0 ? O7/CHECK.DISK <2> SOGDOCI/SYSMEM DMA INPUT PARITY ERROR WHILE IN REA 


D DISK ADDRESS = 001203 

ERROR NOTIFIED ON READING DISK SOGDOC1 

SECTOR 4411/@001203@ NOT DENOTED BAD IN DIRECTORY 
CHECK.DISK ON SOGDOC1 COMPLETED - 

ONE CONSISTENT ERROR NOTIFIED 

1 BAD SECTOR<S> NOT DENOTED IN DIRECTORY 


ooo 2a 
“~a™ wg ~ 


C-2 


ee a i 


COMPARE 


DIFFERENCE(S) FOUND FROM BYTES @002A@ AND @002AE 


RECORD. 1 OF FILE TESTi COMPLETE RECORD - 

BOONOE 2920 2020 2020 2020 5448 4953 2049 S320 4120 5445 5354 2052 4543 4F5e 4420 494E" THIS 18 & TEST RECORD IN" 
OZR 2044 494C 4520 5445 5354 3120 2020 2020 2020 2020 2020 2020 2020 2020 2020 edco" FILE TESTI ; 
@0040E 2020 2020 2020 2020 3030 3030 3031 3030 i 90000100" 

RECORD, i OF FILE Teste DIFFERENCE(S) - 

QODEOG cece cuce cuee cece secs Boece cuve cone wenn teas ceee neve gees eae sees cnet eeseeseaealenseuas peasvesernes an 


HO DIFFERENCES IN SECTION(S) NOT PRINTED 


2032801 
C-3 


DA 


1/0 MIX 
NO. 


ao HOH OM, ORF Om De OO HM OM OOM OO Or; 
Lee 
&o 


C-4 


MESSAGE TEXT 


DA MYDISK PRINTER 


15/DA PRINTER BACKUP FILE SYSTEM/PBOO018 OPENED 


DA. MINI DISK MYDISK 
15/DA  ACPT 

AX 15 DCL 

DA. ILLEGAL PARAMETER DCL 
13/DA ACPT 

AX 15 LABEL 

1S/DA  ACPT 

AX 15 DFH TESTI 

DA. ILLEGAL PARAMETER TESTL 
1S/DA  ACPT 

AX 15 DFH OF TESTI 

1S/DA ACPT 


13/DA ACPT 

AX 15 AVAIL. TABLE AVAIL 
1S/DA  ACPT 
AX_15_NAME.LIST NAMES 
15/DA  ACPT 

AX 15 READ @0140E@ 

15/DA ACPT 

AX 15 END 

DA. TERMINATED 

iS/DA PRINTER BACKUP FILE 


YSTER/PBOOOLE 


SECTOR CARTRIDGE IDENTIFIER HYDISK SERIAL NUMBER 000003 
0/a000000@ OWNERS IDENTIFICATION JOUH 
0/@000000@ OWNERS IDENTIFICATION JOHN | 
INITIALIZATION DATE 82147 INITIALIZATION SYSTEM BDS 
PACK CODE ) ACCESS CODE 
RESTRICTED CARTRIDGE nO INTEGRITY FLAG 1 
BAD SECTOR COUNT 000000 ACTUAL ERROR COUNT 000000 
NUMBER OF CYLINDERS $8/200586 UNIT OF ALLOCATION (SECTORS) 1/8018 | 
NUMBER OF TRACKS/CYLINDER 2/0024 NUMBER OF SECTORS/TRACK 32/8208 
AME LIST ADERESS §2/4002A8 NAME LIST LEHSTH 10/@0A4 
AVAILABLE TAELE ADDRESS 32/400204 AVAILABLE TAFLE LENGTH 10/@0A8 
ADDRESS OF FIRST DTH 92/800344 MAXIMUM NUMBER OF FILES 100/80064@ 
ADDRESS OF PPIT 0740000008 PPIT LENGTH 6/a00¢ 
LOGICAL UNIT NUMBER 0/4004 CMS/WARMSTART DISK 
BOOTSTRAP VERSION 03.04.03 
DISK FILE HEADERS ADDRESS: §2/€000034@ = LEROTH: 100/80000648 SPECIFIED FILE. 1D | 
SECTOR 
53/2000035@ FILE IDENTIFIER TEST! 5445535431202020202020208 
PSEUDO PACK TAS 208 FILE TYPE @00@ = NORMAL DATA 
CREATION DATE 92216 LAST ACCESS DATE 82217 
GENERATION NUABER 0/800008 IMPLEHENTATION LEVEL KUMBER 0/4008 
FLAGS: FILE CRUNCHED - 0 (BIT 0) 
ROUGH TABLE VALID.- 0 (BIT 1) 
DUAL PACK FILE - 0 (BIT 2) 
SINGLE AREA FILE - 0 (BIT 3) 
EXTENDABLE PSEUDO PACK FILE - 0 (BIT 4) 
FILE UPDATED -£ (BIT 9) 
RECORD SIZE 80/a00506 RECORDS/BLOCK 9/800098 
ACT. FILE SIZE 5/4000005¢ SECTCRS/ BLOCK $/800046 
WAX. FILE SIZE 5/@000005¢ SAVE FACTOR ( } 
KAX. AREAS IN USE 1/aole OVERFLOW DISK-ID 
RECS IN LAST AREA 5/40005@ SPARE BYTES IN LAST RECORD 07400000 
USER COUNTS: TOTAL HO. OF USERS - 0 (BITS 0-2) 
FILE OPEN WITH OTHERUSE SHARED - 0 (BIT 3) 
FILE HAS GUTPUT USER - 0 (BIT 4) 
NO. OF SHARED/LOCK ACCESS USERS - 0 (BITS 5-7) 
AREA BIT HAP ALLOCATION ERTRY (ALLOCATION UNITS) NO. OF RECORDS ACTUAL DISK LOCATION (SECTORS) 
12 GF AREA ADDRESS SIZE IN AREA ADDRESS SIZE 
t 1 0 = THIS DISK 152/800988 4/200046 5/@00054 152/80000998 4/09060044 
GTHER(S) 0 0 = URUSABLE 
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C-5 


DA VERSION 3.04.03 ANALYSIS OF HINI DISK MYDISK 06:47:39 ON FRI 6 AUG 82 PAGE 2. 


DISK FILE HEADERS ADDRESS: 52/€0000348 = LENGTH: 106/40000648 SPECIFIED SECTOR 
SECTOR 
54/@000036@ FILE IDENTIFIER COROL¢ 0434F424F 40342020202020208 
PSEUDO PACK TAG e200 FILE TYPE @10@ = S-CODE 
CREATION DATE 82096 LAST ACCESS DATE 82217 
GENERATION NUMBER. 9/800008 IMPLEMENTATION LEVEL NUMBER 0/8008 


FLAGS: FILE CRUNCHED - 0 (BIT 0} 
ROUGH TABLE VALID - 0 (BIT 1) 
DUAL PACK FILE = =9- 0 (BIT 2) 
SINGLE AREA FILE - 1 (BIT 3) 
EXTENDAPLE PSEUDO PACK FILE - 0 (BIT 4) 
1 


FILE UPDATED = (BIT 9) 
RECORD SIZE 180/@0084@ RECORDS/BLOCK 1/800016 
ACT. FILE SIZE 331/20001 488 SECTORS/BLOCK 1/800016 
MAX, FILE SIZE 331 /800014BE SAVE FACTOR { ) 
MAX. AREAS IN USE 1/a01@ OVERFLOW DISK-1D 
RECS IN LAST AREA 331/801 480 SPARE BYTES IN LAST RECORD 0/400008 


USER COUNTS: TOTAL MO. OF USERS - 0 (BITS 0-2) 
FILE OPEN WITH OTHERUSE SHARED - 0 (RIT 3) 
FILE HAS OUTPUT USER ~ 0 (BIT 4) 
NO. OF SHARED/LOCK ACCESS USERS - 0 (BITS 5-7) 


AREA BIT MAP ALLOCATION ENTRY (ALLOCATION UNITS) NO. OF RECORDS ACTUAL DISK LOCATION (SECTORS) 
12 OF AREA ADDRESS SIZE IN AREA ADDRESS SIZE 


i 10 = THIS DISK $2e52/a1ovd = 31/8014 Ra 331/201 4B@ $252/e00109C4 SSL/E0GO14E6 
OTHER(S) 0 0 = UNUSABLE 


eer eee 


AVAILABLE TABLE ADDRESS: 32/@000020@ = LENGTH: 10/400000A@ AVAILABLE ENTRIES. 
ENTRY IN TABLE (ALLOCATION UNITS) ACTUAL DISK LOCATION (SECTORS) 
SECTOR STATUS LENGTH START END (+1) LENGTH START ADDRESS END ADDRESS(+1) 


32/4000020@ 1 AVAIL 2562/@0A02@ 1490/@0469A@ 4252/0109C8 2562/8000A02@ 1690/@00069Aa 4252/800109C¢ 
$1/6000029@ 29 AVAIL 10497204198 4583/Q11E7@ $432/a14008 1049/20004198 4583/@0011E78 5632/8001 6004 


ee a a te a cae oe ee er nth ee we nen ev sere eee, eet 


RAHE LIST ADDRESS: 2/800002A@ = LENGTH: 10/800000A@ NAMES ENTRIES. 
SECTOR NAHE/STATUS PP-TAG INDEX  DFH ADDRESS 
42/e0000zAa = 1 SYSTEM @5357554D4540202020202020€ e208 00 32/0003 48 
2 TESTL €544553543120202020202020€ = dz20@ OL 53/000358 
3 COROLS RHIGF4QCFAC SE 202020202020€ —a20@— 02 94/0003464 
4 COPOL1 QA S4FAZ4F ECL COTEZO2020208 © 20803 35/000378 
5 COPOL2 QE SEF 424F40322020202020208 = A208 =k 94/@00394 
6 COBOLXREF QES4FAZHFECSH5245462020208 = 20005 37/C00590 
? COBOLINTX QHISFAQHF ACETAL TESA 2020208 = 20804 53/aoggAe 
B COBOL.NOTES G4 SSF A24F SC 7EMEMF54$55320@ 208 07 59/@005R8 


C-6 


Da VERSION 3.04.03 ANALYSIS OF MINE DISK HYDISK 08:47:39 ON FRI 4 AUG 82 PAGE 3. 


¢ COBOL @434F424F4C332020202020208 e208 = 08 60/@003C@ 
SECTOR CHARACTER: 01 23.45 67 89 ABCD EF 01 23 45 $7 89 ABCDE F 
5134/8001 4088 o/@0GOd: FFFF FFEF FFFE FFFF FFF FFFF FFFF FRFF FFEF FFF FPF FRE Free FEE PFE FEFF 


32/@020@: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFF FFFF FFFF FFPF 


44/a060@: FFFF FFFF FFFF FFF FFFF FFFF FFFF FFFF FFFF FFFF FFF FFFF FFF FRFF FRPP FPFF 


128/@0808: FFFF FFFF FFFF FFFF FFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF 


160/@0A0@: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FRFF FFFF FFFF 
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-_—_-__eeoeeeeeeee eee 


DSKUTL BOOT 


1/0 WIX MESSAGE TEXT 
NO. 
I 3% DSKUTL_ BOOT DISK2 <COLDSTART> 
0 12 DSKUTL <BOOT> - COLDSTART BOOTSTRAP VERSION 03.04.01 COPIED TO DISK DISK 
2 


C-8 


DSKUTL IN 


1/0 MIX 
NO. 


On OOnF OOH OMe H OMMOore 


Om a Det 


ornoo oOo COT TOF OOH ON OaArN oS 
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MESSAGE TEXT 


DSKUTL_IN 

DSKUTL <IND - ENTER DISK NAME <UP TO 7 LEGAL CHARACTERS> 
{1/DSKUTL ACPT 

AX 11 DISK2 

DSKUTL <IN> - ENTER NO. OF FILES <NUMBER LESS THAN 2805> 
11/DSKUTL ACPT 


AX ii 99 

DSKUTL <IN> - ENTER SERIAL NO. <6 DIGITS> 

L1/DSKUTL ACPT 

aX if 304002 

DSKUTL <IN> - ENTER OWNERS NAME <UP TO 14 CHARACTERS. DELIMIT WITH " > 
L1/DSKUTL ACPT 

AX 11 "BURROUGHS CORP" 

DSKUTL <IN> - IS THIS DISK FOR MTR USE? - <Y OR N> 

11/DSKUTL ACPT 

AX 11 Y 

DSKUTL <IN> - ENTER REQUIRED BOOTSTRAP FILE-NAME OR NULL IF FA/CHSBOOT I 
S 70 BE USED 
Li/DSKUTL «ACPT 

aX i 

DSKUTL <IND - ENTER NO. OF TEST PATTERNS TO BE SPECIFIED <NUMBER 0-4> 
Li/DSKUTL ACPT 

AX 11 1 

DSKUTL <IN> - ENTER 1ST TEST PATTERN <20 CHARACTER HAX. DELIMIT WITH @ I 
F HEX, " IF ASCII> 

L1/DSKUTL = ACPT 

aX 11 GFF 

READY AND RESERVE REQUIRED DRIVE FOR DISK INITIALISE 

LI/DSKUTL <28> WAITING INITIALISE DK DEVICE ASSIGNMENT REQUIRED 

RD DMA 

DMA = RESERVED 0 FILES OPEN 

AD ii DMA 

DMA IS CMS DISK DISK1 - ENTER OK TO CONFIRM <IN> REQUIRED 

11/DSKUTL ACPT 

AX 11 OK 

1ST OF 4 SURFACE CHECK PASSES COMPLETED ON DMA 

OND OF 4 SURFACE CHECK PASSES COMPLETED ON DHA 

3RD OF & SURFACE CHECK PASSES COMPLETED ON DHA 

4TH OF 4 SURFACE CHECK PASSES COMPLETED ON DHA 

MTR BOOTSTRAP VERSION 03.04.00 USED ON DMA DISK DISK2 

0 SECTOR(S) ARE NOT AVAILABLE ON DMA DISK DISK2 

DSKUTL <IN> OF DMA DISK <5432> AS DISK2 ON B90 COMPLETED 

RY DMA 

DMA DISK2/ 0 FILES OPEN 


_-—-—_———————————— 


DSKUTL 


1/0 


SECTOR ADDRESS MINI DISK DISK2 ON DRIVE DKA 


1/80000014 


LIST 

MIX MESSAGE 

NO. 

30 DSKUTL LIST 0 3 
13 

13 

30 RD_DHA 

30 DMA 

30 AD_13 DMA 


FFF 8882877992979 999 

SECTOR ADDRESS LENGTH 
32/80020€ 9/@0009@ 
41/80029@ 10/@000AG 
31/@00336@ 100/@0064@ 
0/80000@ 0/80000¢ 


TEXT 


PRESENT DISK FOR LISTING PLEASE 
13/DSKUTL <28> WAITING LIST DK DEVICE ASSIGNMENT REQUIRED 


RESERVED 0 FILES OPEN 


THU 12 AUG 82 AT 14:15:16.8 PAGE 1. 


ESDGDIF 1F SFOF AF OF OF 2¢0E2D3F 9CPDSEICSDPDSD 344-495 34BS 220206 2F 9F 000 
0000000000425552524F5547485320434F525000000000000000000000000000 
00000000000000000000000000000040E SD4D3F 2F GF 2F 2F 2F ¢404040C2C4E220 
005802200A00002909000020006401 0000330000000000F 1F OF OF OF OF OF OF OF 0 
FOF OF 0F 000000001 000000000000000000000000000000000000000000000000 
0000000000000000000000000000000000000000 

DIRECTORY 

AVAILABLE TABLE 

NAHE LIST 

DISK FILE HEADERS 

PSEUDO PACK IDENTIFICATION TABLE 
FFFFFFFFFFFFFFFFPRFFERPRPPPPPP PP EPPPP PEPE EEEFFFEPFEEFEEEEPEPR 
FFFFFFFFFFFFFFFFEFFFFFFFFFFFPPFPRFEEFFEEFPEPEPREFRFFEFFEFFEEPP 
FFFFFFFFFFFFFFFFFFFFFRFFFFFFFFFFFEEPPEPPEEE FE FPPFEEPFERFEPPEPFEE 
FFFFFFFFFFFFFFFFFFFFFFEFFFFRFEFFFEPEPPEPEPEREFFPEPEEERPEFEEPEERE 
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFEEFRREPPERFEFREPFPRREFFEFEEFFEEPEEF 
FFFFFFFFFFFFFFFFFFFFFFFRFFFFFEFPEPPPFEEF 
38013A000021EA1200005E640B1D00943185197D021 21 1 0051EF F3CB198A01 2E 
0604121 L005 1EF A2A253CF 2BB3EB2E06042E0304120E005315783158198E0312 
0200050C84121000842F 0L000BEEFFB22E0F 043100188£032FB4000300181202 
O071822E120431FF 1 98E032E0C0431F F 198E03081204535503001858D719F 101 
BA11L0B006FE21BFE0112000056040200A2A2821CD301 2E0F 043100188E03120C 
002F0100822F SOOOOBF OF F822E 120431 FF 198E03 


ar ee es rN nee enrttener nen te 


C-10 


i 


DSKUTL RF 


1/0 IX HESSAGE TEXT 
NO. 
I 30 DSKUTL_RF 
0 10 DSKUTL <RF> - ENTER DISK NAME <UP TO 7 LEGAL CHARACTERS? 
0 10 10/DSKUTL ACPT 
I 30 AX 10. DISKI 
0 10 DSKUTL <RF> - ENTER NO. OF FILES <NUMBER LESS THAN 2805> 
9 10 LO/DSKUTL ACPT 
I 30 AX 10 99 
0 10 DSKUTL <RF> - ENTER SERIAL NO. <6 DIGITS> 
0 610 10/DSKUTL ACPT 
I 30 AX 10 304001 
0 10 DSKUTL <RF> - ENTER OWNERS NAME <UP TO 14 CHARACTERS. DELIMIT WITH " > 
0 610 1O/DSKUTL ACPT 
I 30 AX 10 "BURROUGHS CORP" 
9 10 DSKUTL <RF> - IS THIS DISK FOR MTR USE? - <Y OR ND 
9 10 10/DSKUTL ACPT 
I AX 10H 
0 10 DSKUTL <RF> - IS THIS DISK FOR COLDSTART USE? - <Y OR N> 
0 10 10/DSKUTL ACPT 
1 30 AX 10 
0 10 DSKUTL <RF> - ENTER REQUIRED BOOTSTRAP FILE-NAME OR NULL IF FA/CHSBOOT I 
S TO BE USED 
0 10 10/DSKUTL ACPT 
I 30 AX 10 
0 10 DSKUTL <RF> - IS DIRECTORY ON THIS DESK TO BE IGNORED? - <Y¥ OR N> 
0 610 10/DSKUTL ACPT 
I 30 AX 10.Y 
0 10 READY AND RESERVE REQUIRED DRIVE FOR DISK REFORMAT 
0 10 LO/DSKUTL <28> WAITING REFORMAT DK DEVICE ASSIGNMENT REQUIRED 
I 30 RD_DKA 
9 W DMA RESERVED 0 FILES OPEN 
1 30 AD 10 DHA 
0 10 DMA IS CHS DISK FTR - ENTER OK TO CONFIRM <RF> REQUIRED 
0 10 10/DSKUTL ACPT 
I 30 AX 10 OK 
0 10 COLDSTART BOOTSTRAP VERSION 03.04.01 USED ON DMA DISK DISK1 
0 10 0 SECTOR(S) ARE NOT AVAILABLE ON DMA DISK DISKi 
0 10 DSKUTL <RF> OF DMA DISK <5432> AS DISK1 ON B90 COMPLETED 
0 10 PLEASE RUN CHECK.DISK ON DMA DISK DISKi 


2032801 


C1 


KA MYDISK/= 


FRI 6 AUG 82 AT 09: 


INITIALISED 82147 ON 


88 CYLINDERS 
AREA ADDRESS 


© 40000000 
32 80000206 
42 a000d2Aa 
52 0000346 

152 €000098@ 
136 @00009C4@ 
507 @Q001FE@ 
605 @00025D4 
605 40002508 


£ ey 707A 
628 @00035C8 


892 800037C4@ 
1148 400047C@ 
1404 @00057C4 
1580 @00062C¢@ 
1690 @000467A@ 
1714 @0004B2@ 
1764 @0004E48 
$252 @00109C8 
4583 @0O11E7@ 


072139 USAGE HAP OF HINI DISK HYDISK SERIAL NO. 000003 OWNER JOHN PAGE 1. 
1 ERROR CCUNT 000060 BAD SECTOR COUNT doc000 
CHS/WARMSTART DISK BOOTSTRAP VERSION 03.04.03 


2 TRACKS PER CYLINDER 


AREA LENGTH 


32 40000208 
10 e00000A@ 
10 @G0G00A@ 
100 @000064@ 
4 20000040 
351 @00015F@ 
98 0000520 
223 @0000DF@ 
223 a00cdnre 
6% 80000408 
256 40001008 
256 40001006 
176 @0000B00 
110 a00006E@ 
2¢ @000018a 
50 40000320 
2488 @600939@ 
331 @000148@ 
1049 @000619@ 


STATUS 


ASSIGNED 
ASSIGNED 
ASSIGNED 
ASSIGNED 
ASSIGNED 
ASSIGNED 
ASSIGNED 
ASSIGNED 
ASSIGNED 
ASSIGNED 
ASSIGNED 
ASSIGNED 
ASSIGNED 
ASSIGNED 
ASSIGNED 
ASSIGNED 
AVAILABLE 
ASSIGNED 
AVAILABLE 


BDS FOR MAXIMUM OF 100 FILES ALLOCATION UNIT 
32 SECTORS PER TRACK 


FILE NAHE 


RESERVED 
HAVAIL. TABLE 
SFILE DIREC. 
FILE HEADRS 
TEST1 

COROL1 
COBOL2 

COBOL XREF 
COBOLXREF 


COBOL. NOTES 
COBOL NOTES 
COBOL. NOTES 
COBOL 


COBOL4 


LD & CHECKADUMP 


1/0 MIX 
NO. 


rDomromror OO FCO DOC OKF OHO OTM OTe Oreo 
tnd 
pein 
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MESSAGE TEXT 


MTA UNLABELLED 

SN ATA 00001 

MTA PURGED 00001 

DUMP_& CHECK PRINT.DIR TO DEMO C=,MPL=,UTIL= 

EX OOOOOO0/CHSCANDE FILEO2 Ca02 MX02 
OP/CMSCANDE BOJ PRIS C 1317 

O8/LD <10> WAITING DEMO/FLOOO36 AMT NO FILE 

MTA DEMO/ 001 00001 SAVED 

MTA DEKO/ 002 00002 SAVED 

RY_MTA 

MTA DEMO/ 002 00002 

SN_HTA 00002 

MTA PURGED 00002 IN USE BY 08/LD 

MTA DEHO/ 002 00002 

LO/CHECKADUMP =<17> WAITING DEMO/FILEOOO AT NO FILE 
END DUMP 

TRANSFER COMPLETED 

MTA DEMO/ 001 00001 
LO/CHECKADURP =<i7> WAI 
MTA DEMO/ 001 00001 

MTA DEMO/ 002 00002 IN USE BY 10/CHECKADUMP 
NO DISCREPANCIES BETWEEN 

DUMP TAPE DEHO AND DISK SYSTEH 

ATA DERO/ 002 00002 


TING aa aire 


Rerun ver RAAT) or rric 
AO PEMUSPTLYVYoO Ab Ru Poke 


MON 9 AUG 82 13:28:44.1 


DIRECTORY OF PE TAPE 


NUMBER 


FILE 


“OM STO Oo ® GI Ro 


FILE NAME 


COLDSTART 
CMSBOOT 
CHECK. DISK 
CHECKADUHP 
C0 

COMPARE 
CONF IGURER 


COBOLXREF 
COBSVERTER 
CONVERSION 
COBOL INTX 
CHSNDL2 
CHSNDL3 
CHSNDL1 
COBOL NOTES 
CHSCANDE 
COBOL 
CO.MASTER 
CMSBASIC 
COPY 

MPL. BINDER 
MPL.2 
MPL.1 
MPL.SIZE 
MPL .ERRORS 
MPL ..NAHES 
MPL.LISTS 
MPL. NOTES 
UTIL.NOTES1 
UTIL.NOTES2 


DEMO 


ACTUAL 
SIZE 


TAPE SERTAL NUMBER 00002 


DUMPED ON MON 9 AUG 82 AT 13:17:59.3 


MAXIMUM RECORD RECS/ CREATED 
SIZE BLOCK 


SIZE 


180 
180 
180 
180 
180 
180 
180 


ht 


MONON OA ee Oe ee te ek ek et ee OD 


82119 
82048 
81058 
82014 
82048 
81166 
81189 
81058 
81058 
82096 
82096 
82096 
81318 
B1197 
81327 
80323 
81261 
81317 
81317 
81317 
82174 
79269 
82096 
82215 
82134 
81334 
82076 
82077 
82078 
82081 
82042 
82076 
81057 
82174 
82186 
82174 


ACCESSED 


82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
62221 
82221 
82221 
B2221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
82221 
B2221 


SEN. 
NO. 


PAGE = 


FILETYPE 


SYSTEM #158 
SYSTEM @14@ 
CODE #108 
CODE @10e 
CODE e104 
CODE @ide 
CODE @10@ 
CODE @10@ 
CODE #10@ 
CODE #10@ 
CODE e108 
CODE @i0@ 
SYSTEM @¢3@ 
CODE #106 
CODE @10@ 
DATA @008 
SYSTEM @14@ 
CODE a10e 
CODE #108 
CODE #106 
DATA &008 
CODE #108 
CODE #108 
SYSTEM @45@ 
CODE aide 
CODE @10¢@ 
CODE @10e 
CODE @10@ 
CODE #108 
CODE @108 
SYSTEM &408 
SYSTEM #406 
CODE @10@ 
DATA @00@ 
DATA @008 
DATA e008 


LIST 


LIST MYDISK/TEST1 


1 THES IS RECORD ONE LL1111Li111 
LLLLLLLLEDLL2222 02121 21110011111 
1111111100000100 

2 THIS IS RECORD THO © 22222222222 
22e eee 2222 22e222222222222222222 
2222222200000200 

3 THIS IS RECORD THREE 33333333333 
IIIBIIIIIIITIIIIIIIIIIIIIII 
3333333300000300 

& THIS IS RECORD FOUR 44444444444 
BEEEALEAGEERLELA ELA AL RARE EEE AES 
4444444400000400 

3 THIS IS RECORD FIVE 55555555555 
KNSNBNNNSNNENHSNNNNNSNHNNHGNNNN 5] 


3448495320495 32052454346 32442046F $645 20202031 S131 31313131 51913131 
RSRIRIRIRIESRINIRPRORIEIRIRIRIRIRIRSRI ED RIRICIRPRIRIRSRI CP RPRIES 
SL3131513131513130303030303 13050 

34484953204 9532052454 24F 3244205457 4F 202020323232323232 3232523252 
325232323 232523232325232325232525252325252525252525 2525252325252 
32523252323232323030I03030523030 

34486953206953205245434F5244205 4485245 4520333 ISIIIIIIIIIIIIIIIN 
REXREKKERERERESKERERERRERSERERERERSERERERERERESRERRERERRORERERER, 
3333333333I3333I30 0303030333030 

534484953204953205245434F524420464F555220203434343454.34 3434543434 
RERERORC RCSL RUMLRORG MERE RCKO RE RIRERORGRI RI ELRERO RRS RARE RO RG ED RS 
34343434343434345030303030343030 

54484953204953205245434F 524420464 954452020 3535 IS ISISIII IIH 
REREREERE NEN RHR DRDENEN RN GESEN EE SERENE ESR SRD RRENENENEDERENENSD) 


| 3395555500000300 RREWKNENEHENEREREURGRUKGRURRECIE( | 


LIST TEST A 


REC.NO. FILE SYSTEM/TEST1 ON DSK 


THIS IS RECORD ONE 
THIS 15 RECORD TWO 


REC/BLK SIZES = 80/720 FRI 4 AUG 82 AT 11:49:24.3 


LALELLLLLLLLLLRL 22222221 2222202202220 2221211111111100000106 
2oe PP Pe A222 2222 2222222222222 2LocoLe ee LoL eLoLL LLL LOUNOOO20O 


THIS IG RECORD THREE 3333333333 ERRROR 333333333333333353333333I3333II3I000003 00 
THIS IS RECORD FOUR 4444444444444 44d GEE EAE ESLER EEE EEE EEG L GALL EE 444400000400 
THIS IS RECORD FIVE  $55555555595995555555599555555559595959955939555593553500000500 


2032801 


C-15 


LR 


LR MYDISK/=_ <A> 


FRI 6 AUG 82 AT 08:58:52.4 


THITIALISED 82147 GN 
88 CYLINDERS 


FILE 
NAHE 


SRESERVED 

SAVAIL. TABLE 
SFILE DIREC. 
SFILE HEADRS 


COBOLL 
COBOL2 
COBILS 
COBOL4 
COBOLINTX 
COBOLXREF 
Test 

XA 


32 
10 
10 
100 
30 
1342 


RSy| 
98 
116 
Rl 
&4 
223 
3 
24 


SIZE SIZE BLOCK 


2 
10 
10 


180 
180 
180 
180 
180 

80 


180 
180 
180 
180 
180 
180 

20 
180 


32 
22 
32 
32 
1 
9 


30 ee ee ee 


DIRECTORY OF MINI DISK HYDISK 
BDS FOR MAXIMUM OF 100 FILES ALLOCATION UNIT 
2 TRACKS PER CYLINYER 32 SECTORS PER TRACK 
ACTUAL MAXIMUM REC. RECS/ CREATED UPDATED GEN. 
SIZE 


ACCESSED 


82147 $2218 
82147 02218 
82147 22218 
82147 82218 
81058 $2219 U 
82174 82217 U 


82695 82217 U 
82096 82217 U 
820% 82217 U 
82096 82217 U 
81261 82217 U 
81197 82217 U 
82214 82218 U 
81058 82218 U 


FILE VERSION 
NO. =‘ TYPE NO. 


O SYSTEM @20@ 
0 SYSTEM 4208 
Q SYSTEH 8208 
0 SYSTEH 4208 
0 (810227 @10@ 03.04.00 
0 DATA ade 


0 €820404 @108 03.04.05 
& CO20466 €10@ 03.04.05 
© 08204606 G19@ 03.04.05 
0 C820406 4108 03.04.05 
0 SYSTEM @14@ 
0 C810714 4106 
0 DATA ada 
0 €810227 @i0@ 03.04.00 


i 
1 
1 
1 
1 
3 


SERIAL NO. 000003 QUNER JOHN 
1 ERROR COUNT 000080 BAD SECTOR COUAT 090000 
CHS/KARSSTART DISK © BOOTSTaAP VERSION 03.04.03 
Hi. 
AREAS 


ARES 
LOCATIONS 


0 a6600008 

32 @000020¢ 
42 e00002Ae 
52 40000348 
1714 GO006R20 
892 &6C0370@ 
£148 @000¢70@ 
1404 ¢00057C@ 
136 ocosce 
307 @0001FB@ 
1380 40006206 
4252 &00109C@ 
823 e0003ICe 
605 40002506 
152 40000984 
1690 G00049AG 


PASE oi 


AREA 
SIZES 


32 00039208 
10 @b0099Ne 
16 e0dgoonAa 
100 @0009644 
50 800)0728 
256 a000100e 
256 ec001038 
176 angacEea 
351 @090i5F¢ 
99 40000228 
Lid @OCOdSE¢ 
331 UO001488 
64 00000406 
223 40009DF a 

4 a0000048 
24 €9050184 


LR MYDISK/= 100 


FRI & AUG 82 AT 08:59:39.3 


99 CYLINDERS 


INITIALISED 82147 ON 
2 TRACKS PER CYLINDER 32 SECTORS PER TRACK 


BDS FOR MAXIMUM OF 100 FILES ALLOCATION UNIT 1 


DIRECTORY OF MINI DISK MYDISK  SERTAL NO. 000003 OWNER JQN 
ERROR COUNT 000000 BAD SECTOR COUNT 000000 
CHS/WARKSTART DISK BOOTSTRAP VERSIGH 03.04.03 


FILE ACTUAL MAXIMUN REC. RECS/ CREATED UPDATED GEN. FILE VERSION 80. AREA 
NAHE SIZE SIZE SIZE BLOCK ACCESSED WO. TYPE NO. AREAS = LOCATIONS 
COBOL¢ 331 331180 1 82096 82217 U 0 C820406 @10@ 03.04.05 1 4252 Q00Lorle 
COROL? KS} Si 180 1 82096 2217 U Q C820606 @10@ 03.04.05 136 eco909Ce 
CORGLXREF 223 223 180 1 81197 82217 U 0 (810714 @10@ -------- 1 693 0002506 
CORSL NOTES i342 1542-80 ¥ §217¢ S22i7 U & DATA 008 3 872 60003706 
1148 40004708 
1494 a0005708 
COBOL 110 110 189 1 82096 82217 ¥ 0 C820406 @10@ 03.04.05 1 1530 e000d20¢ 
AREA AREA AREA AREA AREA 
ADDRESSES SIZES ADDRESSES SIZES ADDRESSES 
AVAILABLE AREAS 
1764 @O006E4@ 2488 @0009B9@ 4583 @0011E7¢@ 1049 0004194 
TOTAL AVAILABLE SPACE ON DISK 3537 €000DD14 
AREA AREA AREA AREA AREA 
ADDAESSES SIZES ADDRESSES SIZES ADDRESSES 


TEMPGRARY AREAS 


pawn een oooee 


TOTAL SPACE GH DISK IN TEMPORARY USE 


2032801 


0 @000000¢ 


PAGE = 1. 


anes 


AACR 


SIZES 


351 00001488 
3S! QQ00LSF a 
223 @00CODFe 
256 60001008 
256 @0001008 
176 @00GOED8 
110 GQCOGsE@ 


AREA 
SIZES 


AREA 
SIZES 


C-17 


MODIFY 


MODIFY CODE.FILE MYDISK/ COBOL! PPB EOJ.SUPPRESS OFF PPB PRINT.PPB END 


+ MODIFICATIONS SUCCESSFUL + 


C-18 


CMS UTILITY: MODIFY (3.0¢.00] 


CODE.FILE MYDISK/COBOL1 PPB EOJ.SUPPRESS OFF PPB PRINT.PPB END 


PPB OF CODE.FILE MYDISK /COBOLE 


IMP.LEVEL.NO 
PROGRAM NAME 
HARDWARE 

MCP 

PROG. VERSION 
INTERP PACK 
INTERP .PACK 
INTER? .NAME 
COMPILER NAME 
COMPILE DATE 
EOJ. SUPPRESS 
CLASS 

INIT HESS 
ENTRY POINT 
PST.LENGTH 
PST. LOCATION 
DST.LENGTH 
DST LOCATION 
TCB.PA LENGTH 
TCB.PA LOCATION 
STACK LENGTH 
CCB.PA LENGTH 
CCB.PA LOCATION 
TCB.PE LENGTH 
IFNB LENGTH 
IFNB LOCATION 


0 

"OBJCBL 130405" 
@51¢@ 
"03.03.53" 
03.04.05 
"0000000" 

Li] 0000000 it 
“BILINTERP =" 
"MPL 3.3V40 " 
"820406" 


(B1800) 


(A) 


PL 
PL SYS-HLD 15300 


CHS LOG FILE PRINTOUT OF SYS-HLD16300 FROK B90 SYSTEM PAGE 
STATUS OF FILE [$ TRANSFERRED 


MON 11 UUK 84 AT 1991357 


TIME DATE 1/0 MIX ENTRY ODT MESSAGE TEXT 
HHSMASSS MM/DD/YY NO. NO. ID/TAG 


00200853 11/11/11 0 27 1 FFAFFFF LOGGING IS INITIATED ON 11/11/11 AT 00200247 (MCP VERSION 03.05.08) 

00200354 LI/MI/IE 0 27 2 FF/FFFF SO PRBK ON 

00300554 11/11/11 0 30 3 FF/FFFF SO PRBK ON COMPLETE 

00:00:54 LI/iL/iL 0 30 4 FF/FFFF PRINTER SACKUP OPTION 1S ON. PB DISK IS SYS/ DEFAULT BACKUP KAXIMUN 
FILESIZE IS 10000 

03335534 L1/Li/il 1 30 3 01/0019 CTL ON 

03:35:34 11/11/11 0 30 6 OL/O0LD  HAMRREKHKERKHHAREEREREREE «4° COMPUTER MANAGEMENT # 0% = SYSTER 

(OMS) 983328 & & HCP VERSTON 03.05.09 5 RHRHRAHSEEHRESRREEEREREHER 

03:35:35 1/i1/il O 30 7 O1/001D "CTL ON" COMPLETE - SYSTEM SPO STATUS ACQUIRED 

O3:35235 1i/ii/11 6 30 8 01/0010 IF ACCURATE DATE/TINE IS REQUIRED, UPDATE USING “DT” 

03535556 W/T/1L IW 9 OL/O01D DT 06/10/84 1722 

17222200 06/10/84 0 36 = 10 01/001) 10 JUN 86 84142 SUN 1722 

17224207 06/10/84 OD 1 11 01/001D EX OO00000/CHSCANDE FILEOL CR01 MXOL 

17:29:59 06/10/84 I 3 42 01/0010 OL LP 

17229559 06/10/84 GO 30 43 O1/001D LPA READY 

17230200 06/10/84 0 30 14 O1/001D LPS NOT READY 

17:30:00 04/10/84 0 30 = 15 01/001D END OL 

17:32:35 04/10/84 0 3 16 01/001D CANDE TERMINATING. 

16204215 06/11/84 & ai 17 S1/0013 LPB REABY 

10206234 08/11/84 £ 30 = 18 01/0010 & 

10204231 06/11/86 O 30 19 O1/001D DFA SYS/ SYS DISK 17 FILES OPEN 

10:06:31 04/11/86 0 30 2 01/001D DRA NOT READY 

10:06:31 06/11/84 QO 3 21 01/001) MTA NOT READY 

LO0G23L O6/11/84 0 30 22 O1/001D MTB KOT READY 

1004231 06/11/84 0 30 23 01/001) MTC NOT READY 

10206231 06/11/84 0 JO 2% OL/001D MTD NOT READY 

10204531 06/11/84 0 30 25 01/001D RTA 

10206231 04/11/84 0 30 26 O1/O0LD DCA 

10:04:31 06/11/84 0 3 27 01/001D LPA READY 

10204331 04/11/84 0 30 28 O1/001D LPB READY 

10204231 06/11/84 O 3@ 29 O1/001D END OL 

10206238 06/11/84 I 30 36 O1/001D SAVE LPS 

1004244 06/11/84 0 30 31 01/001D LPB READY SAVED 

10206266 O6/11/84 9 30 32 O1/001D LPA READY 

10204245 04/11/84 0 4 33 01/001) LPA READY FOR USE 

10206245 04/11/84 O & 36 OL/001D END SAVE 

90214530 06/11/84 QO 1 35 O1/001D EX OOQQOOO/CMSCANDE FILEO1 CQ01 uXO2 

10215519 06/11/84 I 30 34 OL/001B DLA CHSC= 

10215322 06/11/86 0 6& FH 01/002) Searching for CHSC= on SYS 

10:15:22 04/11/86 0 § 38 01/001D File Id Act Max Rec Block Type Area Address V 
ersion 

10315324 06/11/84 0 & 39 OL/001D CHSCANDE 1103 1103 = 180 1 G10@ § 237672 @OI9FADR 03 
05.04 

£0215:32 06/11/96 0 & 40 O4/001D END OF JOB 

10:16:01 04/11/86 O 5 41 01/001D CANDE TERMINATING. 

10:16:28 06/11/84 I 30 42 01/0010 COPY CNSCANDE TO CNSCANDEI0S 

10:17:02 06/11/84 O 1 43 01/001D EX 0000000/FILEUTL FILEO1 Ca01 HX03 

10217221 06/11/86 IT 30 9 oh OL/QOLD AX 

10:17:22 06/11/84 0 30 435 OL/001D NNBR PROG-NAHE PR STATUS 

10217223 06/11/84 0 30 = 46 O1/001D OL/HCSOBU C EXECUTING 

10517223 04/11/84 0 3 = 47 01/001D 07/COPY B SHORT WAITED ON 1/0 

10:17:23 O6/11/84 0 3 48 01/001) O8/FILEUTL 8 EXECUTING 

10517224 06/11/86 O 30 49 01/001D 29/NBLSYS C SHORT WAITED ON 1/0 

£0817:26 06/11/84 0 30 50 01/0010 END AX 

10217252 06/11/84 0 1 31 O1/001D EX OOOOOOO/FILEUTL FILEO1 CW 8X04 


2032801 


C-19 


HON 11 JUN 84 AT 19513557 


TIME DATE 
HHEMM?SS MM/DD/YY 


10817257 06/11/84 
$0817257 06/11/84 
10218248 04/11/84 
10218221 06/11/84 
10220526 06/11/86 
10523240 06/11/84 
10223540 06/11/84 
10223240 06/11/84 
10223240 06/11/84 
10223240 06/11/84 
10223540 06/11/86 
10823240 04/11/84 
10526250 08/11/94 
10524258 06/11/84 
10:25:21 04/11/84 
10:25:32 06/11/84 
10525542 06/11/86 
10226232 06/11/84 
10526250 06/11/86 
10226357 06/11/84 
10233525 06/11/86 
10533530 06/11/84 
10334206 06/11/86 
10334520 06/11/84 
10237224 06/11/84 
10337225 06/11/84 
10537232 06/11/86 
10237235 06/11/84 
10339834 04/11/84 
10360204 06/11/84 
10240209 06/11/84 
10240220 06/11/84 
LO2GL805 06/11/84 
10241214 06/11/84 
10541526 06/11/86 
10241227 06/11/84 
10541227 06/11/84 
10241227 06/11/84 
10249244 06/11/86 
10249248 06/11/86 
10250200 06/11/84 
10250202 06/11/84 
10250515 06/11/86 
10:50:21 06/11/84 


10250823 06/11/84 


10250350 06/11/84 
10350251 06/11/84 


LOSSLEOP 06/11/84 
10352210 06/11/84 
LO:S330 06/11/96 
10252209 06/11/84 
10552513 06/11/84 


C-20 


1/0 MIX ENTRY 
NO. NO, 


onmoorfe 


CHS LOG FILE PRINTOUT GF SYS-HLDL6300 FROM B90 SYSTEM PAGE «2 


STATUS OF FILE IS TRANSFERRED 
MESSAGE 


ODT TEXT 


ID/TAG 


52 01/001D CMSCANDE COPIED TO CHSCANDES0S 
53 01/0010 END COPY 
54 OL/O01B FT CHSCANDEIOS 00 
55 01/001D FILETYPE OF 
36 OL/OOLE EX OOQOQOO/CHSCANDE FILEO2 
57 O1/001D MX 
38 OL/001D NNER PROG-NANE PR STATUS 
5? 01/001) O1/HCSOBU C SUSPENDED WAITING OW 1/0 
69 O1/001D 09/FILEUTL 8 EXECUTING 
61 01/001) LL/CHSCANDE C SWAPPED OUT, WAITING ON 1/0 
62 01/0010 29/NDLSYS C SHORT WAITED ON 1/0 
63 01/001D END NX 
64 OL/O01D LIST CHSCANDE 317 t 
65 01/001D EXD LIST 
66 O1/001D LPA READY 
67 01/001) LPA READY 
68 O1/001D LPA READY 
6? 01/001) LIST CHSCANDESOS 315 10 
70 04/0010 END LIST 
71 01/001D LPA READY 
72 OL/00LD DC GT TD830X8 
73: 01/001D FROM MCS: GT OK (126) 
74 OL/OO1E CANDE TERMINATING. 
75 O1/001E EX OO00000/CHSCANDE FILEQ2 
76 O1/001D DC NT 
77 01/001D FROH MCS: SYNTAX ERROR - PLEASE RE-ENTER (100) 
78 O1/001D DC NT TD830X8 
79 OL/O0LD FROM MESS RT OK (126) 
80 O1/O01E CANDE TERMINATING. 
81 01/001) DC GT TD8IOXB TEXT 0 
82 O1/O0LD FROM MCS: «GT OK (124) 
83 GL/QOLE EX OODOUOO/CHSCANDE FILEG2 
84 01/0010 DC NT TD830K8 
85 O1/001D FROM MCS: NT OK (126) 
86 OL/00LD SECONDARY LOG FILE SYS-MLG146300 CREATED 
87 01/001D SECONDARY LOG FILE SYS-HLDI6300 CREATED 
88 O1/001D LOG INFORMATION TRANSFERRED 
87 01/001D END TL 
90 O1/001D FT CHSCANDESOS 10 
91 O1/001D FILETYPE OF 
92 O1/001D DC SO THCS 
93 O1/001D FROM MCS: TMCS OPTIONS SET (1074) 
9&4 OL/OOLD EX OOODOOO/CHSCANDESOS FILEO! cq MXO8 
95 O1/001D IB/CASCANDESOS PROGRAM ERROR <105> SEGMENT BOUNDARY VIOLATION AT 
CODE SEGMENT 66 OFFSET 957 PROC/DEBUG LINE 1 
96 01/001) 1B/CHSCANDE3OS MUST BE TERMINATED ENTER : "DS 18/CMSCANDESO5 " 
- TO TERMIWATE OR "DP 18/CMSCANDESOS “ - TO TERMINATE WITH DUMP 
97 O1/O0LD DS 18/CHSCANDE 
98 01/001D DS 18/CHSCANDE INVALID - PROGRAM NAHE DOES NOT WATCH MIX NUMBER E 
NTER "MX" FOR MORE DETAILS 
99 OL/001D BS 18/CNSCANDEIOS 
100 01/001D 18/CHSCANDE30S TERMINATED (DS°ED) 
101 O1/O01D EX QQQQOOO/FILEUTL FILEOL CQOi 
102 01/001) FT CHSCANDEIOS 00 
103 O1/001B FILETYPE OF 


CHSCANDE30S CHANGED FROM $108 TD $00$ 
CQ02 X05 


cade HXO6 


AKG? 


cQ02 


CHSCANDESOS CHANGED FROM $00$ TO $10$ 


MXO9 


CMSCANDE30S CHANGED FROM $106 TO $00 


MOM 11 JUN BS AT 19213557 


TIME = DATE 
HHS MA/DD/TY 


328 06/11/84 
230 06/11/84 
10555254 06/11/84 
10256209 04/11/96 
10254249 06/11/84 
10357518 06/11/96 
10257222 06/11/84 
11200240 06/11/86 
11200243 04/11/84 
11200558 06/11/86 
11202501 06/11/84 
11:03:49 06/11/94 
11:03:50 06/11/84 


11206817 06/11/86 
LL504521 06/11/86 


11504247 06/11/86 
113063469 06/11/84 
11206267 06/11/96 
11205206 06/11/84 
11:05:29 06/11/86 
11505535 04/11/84 
12205237 06/11/9¢ 
18204520 06/11/84 
18517220 06/11/84 
18217228 06/11/84 
18517528 06/11/86 
18217228 06/11/84 
18217259 06/11/84 
18218201 06/11/84 
18518201 06/11/94 
18518518 06/11/84 
18218822 04/11/86 
18518225 06/11/84 
18518528 06/11/84 
1818530 06/11/% 
18218236 08/11/94 
18319310 06/11/84 
18319812 06/11/86 
ABS19512 04/11/86 
18219232 06/11/84 


18519534 06/11/84 
18219234 06/11/86 
18520817 06/11/84 
18220219 06/11/94 
18520219 06/11/84 
19520248 04/11/8¢ 
18520355 06/11/84 
18520255 06/11/94 
18220255 06/11/84 
185202460 06/11/84 
18223522 06/11/84 


2032201 


mM OOH OBOTOCAEH VAN TDA KH TAs OTA O oo eooeo FH OKF ODTORaR Kt 


BV8Sannnn SUUSVUUEBVSSi Se 


Oe OOO rF OOH OO 


Sus 


Se 


CHS LOG FILE PRINTOUT OF SYS-HLD16300 FROM 8970 SYSTEM 
STATUS OF FILE IS TRANSFERRED 


PAGE 3 


1/0 MIX ENTRY ODT MESSAGE TEXT 

NO. NO.  ID/TAG 

30 104 01/001D FT CHSCAMDENOS 10 

21 = 105 O1/001D FILETYPE OF CHSCANDESOS CHANGED FROH $008 TO $108 

15 106 O1/O01E CANDE TERMINATING. 
1 107 O1/001€ EX Q000000/CHSCANDEIOS FILE? Caoe MX10 

22 108 O1/001E CANDE TERMINATING. 

30 109 O1/001E FT CHSCANDESOS 09 

23-110 O1/001E FILETYPE OF CHSCANDE30S CHANGED FROM $10$ TO $00$ 

3 ALL 01/0010 FT CHSCANDES0S 00 

26 112 01/001D FILETYPE OF CNSCANDE3OS CHANGED FROM $008 TO $00$ 
1 113 O1/001D EX 0000000/DC.ANEND FILEOL CQL MX11 

2 114 01/001) Q5/DC. AMEND COMMENCING 1101 
1 115 OL/O01E EX O000000/CHSCANDES0S FILEO? Cwe X12 

JO 116 OL/001E JO/LOADER.SCL PROGRAM ERROR <166> INVALID SIGN CODE AT CODE SEGHE 

NTO OFFSET 63776 DEBUG LINE 8172 , 

1 117 O1/001E EX 0000000/CHSCANDE30S FILEO2 caee HX13 

30 118 O1/001E JO/LOADER.SCL PROGRAM ERROR <166> INVALID SIGN CODE AT CODE SEGHE 

NTO OFFSET 63776 DEGUG LINE 8192 

3H 117 O1/001€ AM CHSCANDE30S 

27 = 120 O1/001E CHSCANDE0S REMOVED 

27) «12h O1/001E END RM 

25 «122 O1/001D 25/DC.ANEND COMPLETED 1105 


123 01/0019 EX QO00000/CNSCANDE FILEOL X14 
124 O1/QOiD DC RG TACS 

125 O1/O01D FROM MCS: TMCS OPTIONS RESET (1075) 
126 O1/001D MTA CBL357/ 001 <30508> 

127 O1/001D PD CHSLIVe 

128 01/001) CHSLIV GN SYS CONTAINS - 

127 OL/O0LD CHSLEVHISRC 

130 01/0010 END PD 

131 O1/O01D CH CHSLIVNISRC TO LIVN.1.SRC 

132 01/001D CHSLIVHISRC CHANGED TO LIVM.1.SRC 
133 O1/O001D END CH 

£34 01/001D PDL =SPEC= 

L35 O1/001D =SPEC= CONTAINS : 

136 01/001D INSPECTS INFSPECSQQ == INFSPECS 
137 01/0019 INSPECT CBLS.SPECPBK BSILS.SPECPBK 
138 01/001D SCLSPEC.C3BK 

139 O1/001D END PD 

140 01/001D CH BILS.SPECPBK TO SPECPBK.BILS 

AGL O1/001D BILS.SPECPBK CHANGED TO SPECPBK.BILS 
142 61/0010 END CH 

143 OL/O0LD CH CBLS.SPECPAK TO SPECPEK.C8LS 


COOL 


144 O1/001D CBLS.SPECPBK CHANGED TO SPECPOK.CBLS 

145 01/001D END CH 

146 01/001D CH SCLSPEC.C3BK TO SPECPBK.SCL 

147 OL/O0LD SCLSPEC.C3BX CHANGED TO SPECPRK.SCL 

168 O1/001D END CH 

149 O1/001B PD B90.0= 

130 01/001D 670.D ON SYS CONTAINS - 

13k OL/00LD 870. DIAGS 

132 61/001D END PD 

153 O1/001D DUMP & CHECK TO SPECDOC LIVM=,SPECPBK=, 870. DIAGS= 

154 O1/001D OJ/LD PROGRAM SUSPENSION <17> ASSISTANCE REQUIRED FOR TAPE FILE § 
PECDOC/FILEGOO 001 TAPE NOT ONLINE 


MON 11 JUN B4 AT 19913557 


TIME DATE 
HASMASSS MM/DD/YY 


18523530 06/11/04 
18523230 06/11/86 
18323330 06/11/84 
18823350 05/11/86 
18525330 06/11/84 
18223550 06/11/86 
18223545 06/11/34 
18523246 06/11/96 
18223246 06/11/84 
19523252 06/11/86 
18224204 04/11/84 
18526510 06/11/86 
18324218 06/11/84 
18824327 6/11/86 
18524333 06/11/86 
18226539 06/11/8¢ 


18526539 06/11/86 
18524258 06/11/84 
18525544 06/11/36 
18525245 06/11/84 
19825245 06/11/86 
18525245 06/11/84 
19525245 06/11/84 
18225245 06/11/84 
18225246 06/11/86 
18526230 06/11/86 
18226230 06/11/86 
18226250 06/11/84 
1GS3L236 OG/E1/94 
4egi237 06/11/24 
18531557 06/11/96 
18531245 06/11/84 
18531566 06/11/06 
18233212 06/11/84 
AS33317 06/11/86 
18233517 06/11/84 


18233519 06/11/86 
18533221 06/11/84 
18:33:23 06/11/84 
18533525 06/11/86 
18233227 06/11/84 
18233329 06/11/84 
18533531 06/11/84 
18533539 06/11/84 


18256337 06/11/84 
18554246 06/11/84 


C22 
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1/0 RIX ENTRY = ODT 
WO. NO. = ID/TAG 


%0 
x” 


CHS LOG FILE PRINTOUT OF SYS-HLD16300 FROM B90 SYSTEM 
STATUS OF FILE IS TRANSFERRED 


HESSAGE TEXT 


155 91/001D OL aT 

156 OL/001D HTA CBL357/ 901 <30508> 

137 01/001D MTB NOT READY 

158 01/0019 MIC NOT READY 

159 01/001) HTD NOT READY 

160 01/0019 END OL 

161 01/001D SH MTA 11JUN 

142 01/0010 LOG INFORMATION TRANSFERRED 

183 01/001D END TL 

144 O1/001D ATA PURGER 

165 01/001D LIVA.I.SRC DUMPED 

146 O1/001B SPECPBK.CBLS DUMPED 

167 01/0018 SPECPBK.BILS DUMPED 

169 01/0019 SPECPEK.SCL DUMPED 

1469 01/001D B90. DIAGS DUMPED 

170 O1/001D OS/CHECKADUMP PROGRAM SUSPENSION <17> ASSISTANCE REQUIRED FOR TAP 
E FILE SPECDOC/FILEQO) 001 TAPE NOT ONLINE 

{71 OL/O01D END DUMP 

172 01/001D MTA SPECDOL/ O01 <11JUN> 

173 O1/001D MX 

174 04/001) NNBR PROG-HAME PR STATUS 

475 01/0010 OL/NCSOB) C SWAPPED OUT, WAITING ON 1/0 


<1LJUN> 


176 01/0010 OS/CHECKADUMP = 8 EXECUTING 
177 O1/001D 26/CHSCANDE C SWAPPED OUT, WAITING ON I/O 
178 01/001D 29/NDLSYS C EXECUTING 


179 OL/OOLD END WX 

180 O1/001D NO DISCREPANCIES BETWEEN DUMP TAPE SPECDOC AND DISK SYS 
181 01/0010 ENB CHECKADUNP 

182 01/001D MTA SPECDOC/ 001 <11L.AR> 

183 01/001D RN SPECPBK/LIVA= 

186 O1/O01D SPECPBK MOT REROVED 

185 O1/001D - FILE ROT FOUND 

186 01/001D LIVA.T.SRC REHOVED 

187 01/0013 END RM 

188 01/001D DLR MPL= 


189 01/0010 Searching for MPL= on SYS 


190 01/001D File Id Act Max Rec Block Type Area Address y 
ersion 

191 01/001D MPL.1 519318 «= 180) 1 A108 = 1 «198712 BOS0RIEG 03 
205.05 

192 01/001D MPL.2 226 «6226 «(18001 B10@ «1310432 BOSBCADE 03 
205.05 

193 01/001D MPL. BINDER 156154) 180) sb GL0B 1114944 BDICBDOE 03 
05.05 

194 01/001D MPL.NAHES 61 é6i 128) = 1 408) =f 428454 B048A708 

195 01/001B MPL.LISTS % 34° «1801 BLO «159060 BOOEKADR 03 
95.00 

194 01/001D MPL.SIZE 24 24 «618001 10@ = 310664 BOGBDEBE 03 
.05.05 


197 01/001D HPL.ERRORS 35 WS 60 F 0G 1 117106 @0109708 
198 01/0010 END OF JOB 
199 01/001D SAVE LPA 


200 O1/001D LPA REABY SAVED 


PAGE 


MOM 11 JUN 84 AT 19513257 


TIME DATE 
HHSMMESS MM/DD/YY 


18:54:08 06/11/84 
18256526 06/11/84 
19257801 06/11/84 
18257202 06/11/96 
18:57:02 06/11/84 
18:57:02 06/11/84 
18257202 06/11/84 
18257502 08/11/94 
18257202 04/11/84 
18:57:52 06/11/86 
18257252 06/11/84 
18037252 04/11/84 
18:57:53 06/11/84 
18557258 06/11/86 
19200230 06/11/86 
19500230 06/11/86 
19200539 04/11/84 
19300347 06/11/84 
19200369 06/11/86 


£9500251 06/11/94 
19:00:52 06/11/84 
19200253 06/11/96 
19200254 06/11/84 
1950055 06/11/84 
1900256 06/11/84 
19200258 06/11/86 
19200259 04/11/84 
19201502 04/11/84 
19201503 06/11/84 
19201503 04/11/84 
19201304 06/11/84 
17201504 04/11/86 
19201206 06/11/86 
19201210 04/11/84 
19201225 06/11/84 
19201225 O6/LL/06 
19201529 06/11/84 
19201532 06/11/84 
19201232 06/11/84 
AP2OLE32 06/11/96 
19201232 06/11/84 
19201532 04/11/94 
19201232 06/11/84 
172Q1532 06/11/94 
19201232 06/11/84 
19201232 06/11/34 
19:01:32 04/11/84 
19801232 06/11/86 
19201232 04/11/84 
19501832 04/11/84 
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CHS LOG FILE PRINTOUT OF SYS-HLD16300 FROM 890 SYSTER PAGE 
STATUS OF FILE IS TRANSFERRED 


1/0 MIX ENTRY ODT MESSAGE TEXT 
NO. HO. ID/TAS 


201 01/001D LPB READY 

202 01/001 LPB READY FOR USE 

203 O1/0010 END SAVE 

206 01/0010 LPB READY 

205 01/001D MTA GOODIES 001 < TOKS> 

206 01/0019 TAPEPD GOODIES 

207 01/0010 HX 

208 01/0010 HNBR PROG-NAME PR STATUS 

209 01/001D 01/HCS0B) C SWAPPED OUT, WAITING OW 1/0 

210 91/001D 08/TAPEPD 8 EXECUTING 

211 O1/001D 26/CHSCANDE © »C_ EXECUTING 

212 01/0010 29/NDLSYS C EXECUTING 

213 01/001) END HX 

21 O1/001D OL LP 

215 01/001D LPA READY SAVED 

216 OL/001D LPB CRL.KAN TH USE BY 26/CKSCANDE 

217 01/001) END OL 

218 01/0010 SAVE LPA 

219 01/001 LPA READY SAVED 

220 O1/001D LPB CBL.HAM © IN USE BY 24/CKSCANDE 

221 01/001D LPB READY FOR USE 

222 01/001 END SAVE 

283 Oi/O0id FE TAPE GOODIES < TOHS> BURPED O# SUR 26 
INS - 

22% O1/001D DOC.EDIT DOC.LIST NOL «ANALYZER 

225 01/001D SYENDLSRC CANDETEACH CHSCANDE 

226 01/001D SYCOM SYCOMLOAD SYETCLSRE 

227 01/001D PDL DCLR DCCP 

228 OL/002D EDITOR DC.AMEND NDLCD 

229 O1/001D LEARN VDUTEACH DLR 

230 O1/001D CHSTEACH DLRS SLIST 

231 O1/001D TUTOR TUT-BASIC NDL.LINE 

232 O1/001D NDL.LINES FT XLTNDLSRC 

233 O1/001D PATCHIT FF.S STRIP.DISK 

236 O1/0019 BF FF STRIP.DISK-S 

235 01/001D ENDOC.EDIT.S ENDOC.EDIT ENDOCHAN 

236 O1/001D ENDOC.MANUAL ENDOC.LIST EXDOC.LIST.S 

237 01/001) END TAPEPD 

238 OL/001D NTA GOODIES/ 001 < TOKS> 

239 O1/601D LOG INFORMATION TRANSFERRED 

240 01/001D END TL 

261 O1/001D BF 

242 01/0010 BF DISPLAYS BACKUP FILE HANES. SYNTAX: 

263 O1/001D <--==-=---~ fo moareece eee i 

246 01/0010! Kee g cocennnee " 

245 O1/001D BF ----------------------- FID> ------> 

266 O1/001D I~ FROM -CHFIDD-! !- a<FIDDE ---! 

247 01/001D f= ON -! 

248 01/0010 I= ALL ------ ! 

249 01/001D I= <INT> ----! 

250 01/0019 1- <I-<12> -! 

251 01/0010 

252 O1/001) -~-=-----2--eee ence anne enna nn na > 

253 01/001) | !-- DETAIL -------------- --! 

25¢ OL/00LD I-- PRINT ----! 
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MON 11 JUN 84° AT 19513257 CHS LOG FILE PRINTOUT OF SYS-HLD16300 FROM B90 SYSTEM PAGE 6 
STATUS OF FILE IS TRANSFERRED 


TIME DATE 1/0 WIX EWTRY ODT MESSAGE TEXT 
SHMESS HN/DD/YY WO. NO. = ID/TAG 


19201232 06/11/84 
19201232 06/11/86 
19201232 06/11/84 
19201244 06/11/84 
19201250 06/11/84 
19201853 06/11/86 
19501553 06/11/84 
19501256 06/11/86 
19501556 06/11/84 
19501255 06/11/84 
19501556 06/11/86 
{9201356 06/11/84 


41 25 01/0010 

Ub 2546 01/001) >------------------------------------ >! 

il 257 01/0010 !~ BEFORE <MM>/<DD>/<YY> -! 

3-258 01/0010 BF ALL DETAIL 

12 259 O1/001D SUPERNOTE.PB PBOO0I0 SUPERSP 3132 05/26/83 @ 11245 DOC.LIST 
250 01/001) PB00002 PBOOO02 = GENTESL 71 06/08/86 @ 13238 COBOLS 
Je 261 O1/001D PROO00S PBOO003 GENTESL 71 06/08/84 @ 13:41 COBOLS 
12 262 O1/001D P800005 PB0000S = GENTESL 70 06/08/84 @ 14:03 COBOLS 
12 263 O1/001D PB00004 PBOO00S GENTESL 78 06/08/84 @ 13546 COBDLS 
12 264 O1/001D P800006 PBOO00S = GENTESL 70 06/08/86 @ 14:12 COBDS 
12 245 O1/001D BIOOONCP.D60 PBOOOSS MLFILEL 374 05/09/84 @ 13527 DOC.LIST 
Le 266 01/001) DCCH.D5S PBO0364 ALFIL 


oooceomocoe cer Sao 
wd 
w 
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PL SYS-MLG.16000 
HON 11 JUN 84 AT 19914221 


PROCESSOR 
iG. 


ee 


2032801 


SYSTEM CONFIGURATION : 


CHANNEL 
NO. 


fe oo et i ie Min 


SUB-CHANNEL 
NO. 


CHS LOG FILE PRINTOUT OF SYS-HLG14000 FROH B90 SYSTEM 


STATUS OF FILE ES TRANSFERRED 


DEVICE 
HO. 


[etl cell call cee Soll “DE eel noel cel 


DEVICE 


DFA 
DNA 
TA 
KT 
HTC 
MTD 
RTA 
DCA 
LPA 
LPS 


HARDWARE DEVICE KIND 


FIXED DISK (211) 

BURROUGHS STANDARD NINI-DISK 
PE REEL 

PE REEL 

PE REEL 

PE REEL 

REAL TIHE CLOCK 

DATA CONN 

LINE PRINTER 

LINE PRINTER 


PAGE 


TOTAL 1/0 COUNT LOGGED 
{EXCLUDING RETRIES) 


éilié 


i 
_ 
eccooo oho 
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WON 11 JUN 84 AT 19814221 CMS LOG FILE PRINTOUT OF SYS-HL616000 FROM B90 SYSTEM PAGE 2 
STATUS OF FILE IS TRANSFERRED 


MAINTENANCE ENTRY ON 06/08/84 AT 11206203 


NIX PROCESSOR/ INPUT/ OPCODE TYPE OF MFID «SERIAL «NO. OF SUCCESS? =GUFFER BUFFER SECTOR 
CHANWEL/ QUTPUT OPERATION WUNBER RETRIES POINTER LENGTH START 
SUB-CHANNEL/ (BYTES) ADDRESS 
DEVICE 4O./ 

DEVICE 
7200 
202 01/07/ /OL/ATA INPUT oY READ GHCOO) «=: 84072 6 NO @OO1C208 


ERROR TYPES- PARITY 
STATUS = §- 0307 1001 
DESCRIPTOR:~ CIES BASF FDOO 0014 0020 100 0940 0802 0000 0601 0500 0000 0000 00 


MAINTENANCE ENTRY ON 04/08/84 AT 11507509 


MIX PROCESSOR/ INPUT/ §OPCODE TYPE OF MFID = SERIAL NO. OF SUCCESS? BUFFER SUFFER SECTOR 
CHANNEL/ CUTPUT OPERATION NUMBER RETRIES POINTER LENGTH START 
SUB-CHANNEL/ (BYTES) ADDRESS 
DEVICE HO./ 

DEVICE 
7200 
9 O1/07/ /OL/ATA INPUT 40 READ GMCS00 «= 94072 & NO WMO1C208 


ERROR TYPEs- PARITY 
STATUS = - (0307 1C0L 
DESCRIPTOR:- C1E3 BASF FDOO 0014 0020 1000 OB40 0800 0000 0601 0500 0000 0000 00 


MAINTENANCE ENTRY ON 06/08/86 AT 11210221 


MIX PROCESSOR/ INPUT/ OPCODE TYPE OF MFID SERIAL NO. OF SUCCESS? BUFFER BUFFER SECTOR 
CHANREL/ QUTPUT OPERATION HUNGER = RETRIES POINTER LENGTH © START 
SUB-CHANNEL/ (BYTES) ADDRESS 
DEVICE WO./ 

DEVICE 
7200 
463 O1/07/ /OL/NTA INPUT 40 READ GMCSOO = 84072 1 YES &01C208 


STATUS = 0304 1005 
DESCRIPTOR:- CLES BEAB 3406 0014 0020 1000 0£40 0802 0000 0101 0500 0000 0000 00 


MAINTENANCE ENTRY ON 06/08/84 AT 11:10:28 


4IX PROCESSOR/ INPUT/ §=OPCODE TYPE OF WFID «SERIAL NO. OF SUCCESS? BUFFER BUFFER SECTOR 
CHANNEL/ OUTPUT OPERATION NUMBER RETRIES POINTER LENGTH START 
SUB-CHANNEL/ (BYTES) ADDRESS 
DEVICE NO./ 
DEVICE 
7200 
143 O4/07/  /O1/MTA INPUT 40 READ GHCS0O =. 84072 ) NO @001C208 


ERROR TYPE:- PARITY 
STATUS =~ 0308 1005 
DESCRIPTORS~ CLEJ BAAB 3406 O14 0020 1000 0C40 0902 0000 0601 0500 0000 0000 00 


C-26 


MON 11 JUN 86 AT 9ciGsat CMS LOG FILE PRINTOUT OF SYS-HLG14000 FROM B70 SYSTER PAGE «3 


STATUS OF FILE 1S TRANSFERRED 


SUMMARY BETWEEN ENTRY DATED 11:05:03 OW 06/08/04 
AND ENTRY DATED 11210528 ON 06/08/84 


PROCESSOR/ TOTAL 1/0 HO. INPUT NO. OF © MUNBER OF NUMBER OF = NO. OUTPUT NO. OF NUMBER OF NUMBER OF 
CHANNEL / COUNT LOGGED HAINTENANCE INPUT © SUCCESSES FATLURES MAINTENANCE OUTPUT SUCCESSES FAILURES 
SUS-CHANNEL/ IN FILE ENTRIES RETRIES ENTRIES RETRIES 

DEVICE NO./ 

DEVICE 


01/03/ = /01/DFA S1llé 
01/02/  /01/DMA 4 
01/07/ /O1/KTA 1162 
1/074 /02/HTR 6 
01/07/  /03/KIC 0 
01/07/  /06/KTD 0 
01/044 AOL/RTA 0 

Ly) 

0 

8 


— 


eoco oe eo owa oOo 


OL/05/  /01/DCA 
O1/01/  /O1/LPA 
OL/06/  /O1/LPB 


eooce@oo fo cf 
@eoqccocccorce 
ecoceoo ouwcs 
ecrcreoccceccocao So 
acocoococo coc 
ococcocoo co 


2032801 


C-27 


sa 


SQ MYDISK VERIFY FAST 400 LIST 


*** SQUASH VERSION 3.4.02 (03/05/82) *** 

*** VALIDATION PHASE BEGINS *** 

LARGEST AVAILABLE SPACE IS 2488 SECTORS 

TOTAL AVAILABLE SPACE IS 3537 SECTORS IN 2 AREA(S) 
*** SQ COMPLETED *** 


USAGE MAP OF DISK HYDISK BEFORE SQUASH . DATE : FRI 6 AUG 82 


FILE NAME AREA FILE DISK ALLOCATION AVAILABLE TABLE REMARKS 
NB OPEN LENGTH FROM INFORMATION 


| 2 €000000€ = ROG00IF@ = ERESERVED 
10 €000020@ = 000029@ «= KAVAIL. TABLE 
10 €00002A@ = 4000033@ = FILE DIRECTORY 
100 €000034@ © 000097 = SFILE HEADERS 


TESTt 1 4 80000988  a00007Be 
COBOLI 1 351 AOOOOPTA = RODOIFAG 
COBOL2 1 98 GO001FB@  a00025C4 
COBOLXREF i 223° = @00025D€ =: 4000338e 
COBOLINTX 1 64 =©00TIC@ §=— 80003788 
COBOL.NOTES © 1 256 = 4000370 =. 0004784 
COBOL.NOTES 2 2536 = 0004708 = @00057Be 
COBOL.NOTES 3 176 = @000S7C@ = 0006288 
COBOL 1 110 @00062C@ =. 80004998 
XA 1 24 = AOD0067AG@ = 0006814 
AMEND 1 50 @0006B2@ = Q0004E3@ 
2488 = @0006ES@ = 400109B@ = AVAILABLE SPACE 
COBOL4 1 331 MO0109C@ = AOL LEGA 


1049 = @OOL1E7@ = @OOLSFF@ © AVAILABLE SPACE 


NOTE : NO ERRORS DISCOVERED IN VALIDATION PHASE - USAGE MAP OF THE DISK ENDS 


PAGE 1, 


TAPELR 


TAPELR DEMO 
MON 9 AUG 82 AT 11:28:55.7 TAPE SERIAL NUMBER 12345 PAGE 1. 
DIRECTORY OF PE TAPE DEHO DUMPED ON MON 9 AUG 82 AT 10:49:35.8 
| FILE FILE NAME ACTUAL MAXIMUM RECORD RECS/ CREATED GEN. FILETYPE 
NUMBER SIZE §iZeE SIZE BLOCK ACCESSED NO. 
1 COLDSTART 144 144 180 @ 82119 82221 Q SYSTEM @15@ 
2 CHSBOOT 121 121 180 1 82048 82221 Q SYSTEM e144 
| 3 CHECK. DISK i 37 180 1 81058 82221 0 CODE @106 
& CHECKADUHP 44 44 180 _1 82014 82221 o CODE @10@ 
3 CO 164 164 180 1 82048 82221 0 CODE @10¢ 
6 COMPARE ~ 49 49 180 £81166 82221 0 CODE @10¢@ 
7 CONFIGURER 39 39 180 1 81189 82221 0 CODE @10¢@ 
8 CP 25 25 180 1 81058 82221 0 CODE 4108 
9 CREATE 38 38 180 1 81058 82221 0 CODE @10@ 
10 COBOL4 331 331 180 1. 82096 82221 0 CODE @10¢ 
11 COBOLI 35t 351 180 1 82096 82221 0 CODE @10@ 
12 COBOL2 98 98 180 1 82096 82221 0 CODE 4108 
13. COBERRS 121 121 180 1 81318 82221 Q SYSTEM @43@ 
| 14 COBOLXREF 223 223 180 1 81197 82221 0 CODE 4104 
15 COBSVERTER 50 8G 186 1 81327 82221 O CObe ace | 
16 CONVERSION &6 66 90 20 80323 82221 0 DATA @00@ 
17 COBOLINTX b4 &4 180 1 81261 82221 O SYSTEM @14¢ 
18 CHSNDL2 350 350 180 1 81317 82221 0 CODE 410@ 
19 CMSNDL3 211 2il 180 1 81317 82221 6 CODE 108 
20 CMSNDL1 © 46 46 180 1 81317 82221 0 CODE @10¢ 
21 COBOL.NOTES 1542 1342 80 9 82174 82221 QO DATA 4004 
22 CMSCANDE 225 225 180 1 79269 82221 0 CODE 410é@ 
23 COBOL3 110 110 180 1. 82096 82221 0 CODE @10@ 
24 CO.MASTER 27 27 180 1 82215 82221 O SYSTEM @45¢ 
25 CMSBASIC 492 492 180 1 82134 82221 0 CODE @10@ 
26 COPY 79 79 180 1 81334 82221 6 CODE @10¢@ 
27 =MPL.BINDER 141 141 180 1 82076 82221 0 CODE @10¢ 
28 MPL.2 190 190 180 1 82077 82221 0 CODE @10¢ 
29 MPLLE 430 430 180 1 82078 82221 ¢ CODE @10¢@ 
30 MPL.SIZE 21 21 180 1 82081 82221 Q CODE 4@10¢ 
21 MPL.ERRORS 305 305 40 3 82042 82221 Q SYSTEM @408 
32 MPL.NAMES 45 45 128 1 82076 82221 0 SYSTEM 4404 
33 MPL.LISTS 34 3 180 1 91057 82221 0 CODE @10é 
34 HPL.NOTES 432 432 80 9 82174 82221 0 DATA @00@ 
35 UPDATE &4 64 180 1 81327 82215 0 CODE @10@ 
36 UTIL.NOTES1 11134 11134 80 9 82186 82215 0 DATA ade 
UTIL .NOTES2 7391 7391 9 82174 82215 0 DATA 4004 
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—_—— “re SSeS 
TAPEPD 


TAPEPD ARTAPE 


NRZI TAPE ARTAPE «000002 DUMPED ON THU ?1 
»«» JUN 79 CONTAINS -: 

MYFILE MYFILEQQ A999 

END TAPEPD 
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APPENDIX D 
RELATED DOCUMENTATION 


The following manuals provide information concerning CMS System Software: 


Manual 
CMS ARCS Reference Manual 
CMS COBOL Reference Manual Relative to Release 3.05 
CMS MCP Reference Manual 
CMS RPG Reference Manual Relative to Release 3.05 
CMS MPLII Reference Manual Relative to Release 3.05 
CMS NDL Reference Manual 
CMS Data Communications Subsystem Reference Manual 
CMS BASIC Reference Manual 
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Documentation Evaluation Form 


Title: __B.90/B 900/CP 9500/B 1800/B 1900 CMS 
Software Operation Guide Relative to Release 3.05 


Form No: 2032801 
Date: March 1985 


Burroughs Machines Ltd is interested in receiving your 


eanctyy hic mmaniis 


. i 1 
uing revisions tO improve this Manua. 


Please check type of Suggestion: 
QO Addition (J) Deletion OO Revision O Error 


Comments: 
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Title 


Company 
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Date 


Remove form and mail to: 


Corporate Product Information 
Burroughs Machines Limited 
Cumbemauld. Glasgow G68 OBN 
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